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PARTI 

CHAPTER 1: AN INTRODUCTION TO THE BINARY NUMBER SYSTEM 
1.1 BINARY NUMBERS: 

NUMBERS IN EVERY DAY USE ARE WRITTEN IN THE DECIMAL SYSTEM, THAT 
IS, TO THE NUMBER BASE 10. A POSITIONAL NOTATION IS USED 
REPRESENTING ONE '100's; TWO '10's & EIGHT '1's AS THE SYMBOL 128. THE 
RIGHTMOST (i.e. LEAST SIGNIFICANT) DIGIT IS IN THE "UNITS" COLUMN, THE 
2 IN THE "TENS" COLUMN, THE 1 IN THE "HUNDREDS" COLUMN, AND THE 
VALUE OF THE SYMBOL '128' IS EVALUATED AS 1x100+2x10 + 8x1 = 128. 
SIMILARLY '1024' IS EVALUATED AS 1x1000 + 0x100 + 2x10 + 4x1 = 1024,WHICH 
IS MORE CONVENIENTLY WRITTEN AS 1x10' +0x10^ +2x10' 4x10" = 1024, 
USING THE MATHEMATICAL SHORTHAND FOR 1000= 10x10x10= 10^AND 
THE CONVENTION "ANY NUMBER TO THE POWER ZERO ISV'TOGIVE A 
CONSISTENT METHOD OF EVALUATING SUCH SYMBOLS. 
SO 1024 
CAN BE WRITTEN IN COLUMNS 
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AND EVALUATED AS 1x10' +0x10^ +2x10' +4x10° 

TO THE BASE 10. 

TO THEBASE8, 1024 WOULD MEAN 1x8' +0x8^ +2x8' +4x8" WHICH IS THE 

DECIMAL NUMBER 532. 

TO THE BASE 16, 1024 WOULD MEAN 1x16' +0x16^+2x16' +4x16° WHICH IS 

THE DECIMAL NUMBER 4132. 

TO DISTINGUISH THE BASE TO WHICH A NUMBER IS WRITTEN WE'LL WRITE 

ITS' BASE AFTER IT AS A SUBSCRIPT: 1024io AND NOW WE CAN WRITE 

1024« = 532, o| 



1024i6 =4132ioi 
100000002 = 128 10 

JUST AS BASE TEN HAS THE NAME 'DECIMAL', BASE SIXTEEN HAS THE NAME 
'HEXADECIMAL', BASE EIGHT HAS THE NAME 'OCTAL' AND BASE TWO 
'BINARY'. THESE FOUR BASES ARE IN COMMON USE WITH MODERN 
COMPUTERS, ESPECIALLY HEXADECIMAL (HEX) AND BINARY. CONVERSION 
BETWEEN BINARY, OCTAL & HEX NUMBERS IS VERY SIMPLE. SINCE THEY ARE 
ALL POWERS OF TWO, NUMBERS JUST NEED DIVIDING UP:- 
100000002= 1 1000 1 1 00001 16 = 80i6 

= I010I1000II000I8 =2008 
- EACH HEX DIGIT IS FOUR BINARY DIGITS (BITS) & EACH OCTAL DIGIT IS 
3 BITS. 

OCTAL DIGITS ARE 0, 1, 2, 3, 4, 5, 6, 7. 

HEX DIGITSARE0,1,2,3,4,5,6,7,8,9,A,B,C,D,E,F A....F ARE USED 
INSTEAD OF 10....15 TO ALLOW UNRESTRICTED USE OF THE POSITIONAL 
SYSTEM. 



PROGRAM COUNTER: 16 BIT REGISTER WHICH CONTAINS THE ADDRESS OF 

THE INSTRUCTION BEING EXECUTED. DURING EXECUTION THE 

PROGRAM COUNTER ISSTEPPEDUPTOPOINTATTHE NEXT INSTRUCTION. 
PROM: PROGRAMMABLE READ ONLY MEMORY. THIS TYPE OF MEMORY 

ARRIVES BLANK. IT CAN BE PROGRAMMED BY THE USER WITH THE 

HELP OF A SPECIAL PROM BLOWER. ONCE THIS PROGRAM HAS BEEN PUT 

IN, IT CANNOT BE CHANGED. 
RAM: RANDOM ACCESS MEMORY. THIS IS THE STANDARD READ/WRITE 

MEMORY. DATA (AND PROGRAMS) ARE LOST WHEN THE POWER IS 

SWITCHED OFF. 
REGISTER: STORAGE LOCATION IN THE MICROPROCESSOR ITSELF. THERE 

ARE INTERNAL REGISTERS A, X, Y, PC, S, P. 
ROM: READ ONLY MEMORY. THIS IS MEMORY THAT HAS A PROGRAM PUT 

IN DURING PRODUCTION. THIS PROGRAM CANNOT EVER BE CHANGED, 

IT CAN ONLY BE READ. 
STORE: TRANSFERS DATA FROM AN INTERNAL REGISTER TO MEMORY. 
XTAL: THE CRYSTAL IN THE ACORN OSCILLIATES AT 1 MHZ. i.e. ONE 

Ml LLION TIMES A SECOND. IT DOES THIS WITH GREAT ACCURACY. SO 

YOU CAN BUILD A CLOCK FROM YOUR ACORN. 
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THE ACORN MICROPROCESSOR IS DESIGNED TO DEAL WITH 8 BITS AT A TIME. 
THE COLLECTION OF 8 BITS IS GIVEN THE SPECIAL NAME 'BYTE', AND IS 
NORMALLY WRITTEN IN HEXADECIMAL OR BINARY. A BYTE THUS IS 0....FFi6; 
0....IIIIIIII2 OR 0....255io. THE MICROPROCESSOR CAN CARRY OUT LOGICAL 
AND ARITHMETICAL MANIPULATIONS ON BYTES. 

1.2 LOGICAL MANIPULATIONS 

THE MICROPROCESSOR CAN IMMEDIATELY CARRY OUT THE LOGICAL AND, 
EXCLUSIVE - OR & OR FUNCTIONS ON ALL 8 BITS SIMULTANEOUSLY, USING 
THE FOLLOWING TRUTH TABLES FOR EACH BIT (SYMBOL 'b') 
AND ( A ) EXCLUSIVE - OR ( V ) OR ( V ) 
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EXAMPLE 






OPERANDS 




00111100 




00111100 


01011010 


AND 

(OPERATOR) 

RESULT 


01011010 


00011000 


01100110 



E-OR 



00111100 
01011010 OR 



01111110 



1.3 ARITHMETIC MANIPULATIONS 



BINARY ADDITION 
WITH CARRY OUTPUT 



BINARY ADDITION WITH CARRY FROM RIGHT 
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EXAMPLE: 00111100 SCig 60, o 

01011010 + 5Ai 6 + 90 1 + 

10010110 96i6 15010 

IN ORDER TO MAKE LONGER ADDITIONS EASIER TO PROGRAM, THE 
MICROPROCESSOR HAS A CARRY BIT (FLAG). AT THE START OF AN 
ADDITION THIS IS TREATED AS THE INPUT CARRY, AND AT THE END IT 
RECEIVES THE CARRY OUT FROM THE SUM AT BIT 7: ASSUMING WE HAVE A 
CARRY INPUT: 



11000011 

10100101 CARRY IN 
[1] + 



C3,6 
A5.6 



195,0 
165,0 

_!io+ 

CARRY OUT Q] 01101001 169,6 361, o 

SUBSTRACTION OPERATES IN A SIMI LAR MANNER, EXCEPT THAT THE 
CARRY (OR BORROW) FLAG OPERATES UPSIDE DOWN: A CARRY FLAG IS 
TREATED AS REPRESENTING A BORROW FROM THE PREVIOUS STAGE: 
11111111 FF,6 255,0 

00000000 00,6 000,0 

^ _0,6 _0io 

0] 11111110 1FE,6 51010 

NOT QUITE THE RESULTS ONE MIGHT HAVE WISHED FOR! (SUPERFICIALLY) 
THIS OCCURS BECAUSE OF THE HARDWARE IMPLEMENTATION OF 
SUBTRACTION A SUBTRACTION, (P-O), IS REGARDED BY THE MICRO- 
PROCESSOR AS THE EQUIVALENT (P+(-Q)), BECAUSE THERE IS A SIMPLE 
WAY TO GENERATE THE NEGATIVE OF A NUMBER. 

THE 'ONES-COMPLEMENT' OF A BINARY NUMBER IS SIMPLY GENERATED BY 
EXCHANGING '0's & '1's: 

'I's 000011002 0C,6 12,0 

COMPLEMENT 111100112 F3,6 243,0 

IF THIS ONE'S-COMPLEMENT IS TO BE THE NEGATIVE OF A NUMBER, 
WE SHOULD GET ON ADDITION: 



GLOSSARY 

- ACCUMULATOR: 8-BIT CENTRAL REGISTER IN THE MICROPROCESSOR. 

MOST INFORMATION HAS TO GO THROUGH IT. 

- ADDRESS: 16 BIT POINTER TO A MEMORY LOCATION. THE 6502 MICRO- 

PROCESSOR CAN ADDRESS 65, 536 SUCH LOCATIONS (WHICH IS 2' * ). 

- ARITHMETIC LOGIC UNIT (A.LU.): A SECTION OF THE MICROPROCESSOR 

WHICH CARRIES OUT ARITHMETIC (ADDITION, SUBTRACTION, 
INCREMENT, DECREMENT & COMPARE) AND LOGIC ("AND"."EOR", 
"OR", & BIT SHIFTS) MANIPULATIONS. THIS IS THE ONLY PART OF ' 
THE MICROPROCESSOR WHICH ALTERS DATA. 

- COMMAND: THE MONITOR FUNCTIONS M,G,P,R,L,S,t',4.. 

- DATA: INFORMATION FOR THE PROCESSOR THAT DOES NOT HAVE TO BE 

TRANSLATED, e.g. "AD" AS DATA ACTUALLY MEANS 10x16+13x1 = 173,0 
WHEREAS THE INSTRUCTION "AD" GETS TRANSLATED INTO THE 
OPERATION "LOAD ACCUMULATOR ABSOLUTE". 

- EPROM: ERASABLE PROGRAMMABLE READ ONLY MEMORY. THIS TYPE 

OF MEMORY IS LIKE A PROM, BUT CAN AGAIN BE ERASED BY 
EXPOSING THE CHIPTO ULTRAVIOLET LIGHT. 

- FLAGS: ONE BIT INTERNAL REGISTERS. ALL SEVEN FLAGS CAN ALSO BE 

TREATED AS SEPARATE BITS OF THE P REGISTER (PROCESSOR STATUS). 

- INDEX REGISTER: A REGISTER WHICH CAN BE USED TO MODIFY AN 

ADDRESS (USED IN REFERRING TO DATA) BY BEING ADDED TO IT, THUS 
ACCESSING A CERTAIN ELEMENT OF A TABLE. THE 6502 HAS TWO INDEX 
REGISTERS CALLED X & Y. 

- INSTRUCTION: A FUNCTION OF THE MICROPROCESSOR LIKE LOAD AND 

STORE. 

- I/O: INPUT/OUTPUT. THIS CHIP ALLOWS YOU TO COMMUNICATE WITH THE 

OUTSIDE WORLD. IN THE ACORN THE I/O CHIP HAS 16 PROGRAMMABLE 
LINES WHICH CAN EITHER BE OUTPUTS OR INPUTS. IT ALSO HAS 128 
BYTES OF RAM. 

- IRQ: INTERRUPT REQUEST. IF FLAG I (INTERRUPT DISABLE) IS CLEAR AND 

A REQUEST IS MADE THE PROCESSOR Wl LL ATTEND TO IT AFTER 
SETTING FLAG I AND STORING THE PROGRAM COUNTER AND STATUS 
REGISTER. 

- JUMP: THE PROGRAM COUNTER IS LOADED WITH A NEW ADDRESS. THE 

EXECUTION OF THE PROGRAM, WHICH IS NORMALLY USING 
CONSECUTIVE ADDRESSES, CONTINUES (JUMPS) AT THIS NEW ADDRESS 

- LOAD: TRANSFERS THE DATA OF A MEMORY LOCATION TO AN INTERNAL 

REGISTER. 

- MNEMONIC: SUGGESTIVE ABBREVIATION OF AN INSTRUCTION e.g. THE 

INSTRUCTION "LOAD ACCUMULATOR ABSOLUTE" HAS THE MNEMONIC 

"LDA". 
-NMI: NON MASKABLE INTERRUPT WHEN THE NON MASKABLE INTERRUPT 

ISACTIVATEDTHE PROCESS WILL SET FLAG I, STORE AWAY ITS 

PROGRAM COUNTER AND STATUS REGISTER AND THEN IMMEDIATELY 

ATTEND TO THE INTERRUPT. THERE IS NO WAY OF PREVENTING THIS 

INTERRUPT. IT HAS PRIORITY OVER IRQ. 
-OPCODE: HEXADECIMAL REPRESENTATION OF AN INSTRUCTION eg THE 

INSTRUCTION "LOAD ACCUMULATOR ABSOLUTE" HAS THE MNEMONIC 

"LDA" AND THE OPCODE "AD". 
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0018 


P 


0019 


COL 


001 A 


TX.TY 


001C,001D 


USERNMI 


001 E, 00 IF 


USERIRQ 


001 B 


RECAL 


FE00 


QUAD 


FE0C 


DISPLAY 


FE5E 


MHEXTD 


FE60 


RDHEXTD 


FE64 


QHEXTD1 


FE66 


QHEXTD2 


FE6F 


DHEXTD 


FE7A 


HEXTD 


FE88 


QDATFET 


FEA0 


C0M16 


FEA6 


NOINC 


FEB1 


PUTBYTE 


FECD 


WAIT 


FED0 


% WAIT 


FEDD 


GETBYTE 


FEF3 


RESET 


FF04 


RESTART 


FFB3 


BREAK 


FFEA 


FONT 


0015 


RECAL 



BASE ADDRESS OF THE EIGHT DISPLAYED MEMORY 

LOCATIONS, REGISTER 4: TEMPORARI LY PCH AFTER 

BREAK. 

REGISTER 5: TEMPORARI LY PCL AFTER BREAK 

REGISTER 6: TEMPORARI LY 01 AFTER BREAK 

REGISTER 7: TEMPORARI LY S AFTER BREAK. 

LAST 4 DISPLAYED MEMORY LOCATIONS. 

SINGLE LEVEL OF STORAGE FOR PREVIOUS DATA AT 

BREAKPOINTS. 

COLUMN OF KEY CURRENTLY BEING PROCESSED 

TEMPORARY STORAGE FOR X (IN DISPLAY) OR Y 

(VARIOUS PLACES). 

ADDRESS OF USER'S NMI PROGRAM 

ADDRESS OF USER'S IRQ PROGRAM 

CONTAINS PC RECALCULATION FACTOR FOR BREAK 

DISPLAY X-3,X-2,X-1 ,X ON THE DISPLAY; THEN I 

STROBE KEYBOARD, MULTIPLEX DISPLAY, RETURN 

WITH KEY INFORMATION 

DISPLAY A MEMORY BYTE ON RIGHT OF DISPLAY 

DISPLAY A ON RIGHT OF DISPLAY 

DISPLAY X & X+1 ON DISPLAYS 1 ,2,3 & 4 

DISPLAY X & X+1 ON DISPLAYS Y-2,Y-1, Y & Y+1 

DISPLAY A ON DISPLAYS Y & Y+1 

DISPLAY BOTTOM 4 BITS OF A ON DISPLAY Y 

FETCH AN ADDRESS INTO LOCATIONS X & X+1 

INCREMENT & COMPARE TWO 16 BIT NOS X+6,X+7 & 

X+8,X+9 

COMPARE X+6,X+7 & X+8,X+9 FOR EQUALITY 

A TO TAPE, DO 1 START & 1 STOP BITS, NO PARITY 

WAIT FOR CASSETTE TIMING 

HALf THE WAIT 

TAPE TO A, WAIT FOR START BIT, CENTRE TIMING 

ENTRY TO MONITOR 

RE-ENTRY TO RUNNING MONITOR 

ENTRY TO MONITOR FROM BRK INSTRUCTION, 

DISPLAY CPU 

SEVEN SEGMENT PICTURES OF THE HEX DIGITS 

CONTAINS PC RECALCULATION FACTOR FOR BREAK 



000011002 
11110011, + 



0Cl6 

F3,6 + 



12io 
243io + 



IIIIIIII2 



FF 



16 



WHICH DOESN'T HAPPEN .... UNTIL WE ADD AN EXTRA 1 : 
000011002 0Ci6 
IIII00II2 F3i6 
h + I16 + 



255,0 

12io 
24310 
_lio 
256io 



16 



1 \p\p\p\p\p\p\t)\p2 

AND THEN TREAT THE OUTPUT CARRY AS INDICATING THE ABSENCE OF A 
BORROW FROM THE HIGHER ORDERS. 

THE NUMBER (ONE'S-COMPLEMENT + 1) IS CALLED THE TWO'S-COMPLEMENT 
OF A NUMBER: 

BINARY HEXADECIMAL 

00000001 2 01 16 



IIIIIIII2 
111111102 

111101002 
100000002 
0IIIIIII2 
SO A BYTE CAN BE TREATED AS A 



FF16 
FEie 

F4,6 



DECIMAL 

+ I10 

+01 or -01 

-I10 
-2io 



-12,0 
8016 -128,0 

7F,6 +127,0 

SIGNED BINARY NUMBER' IN THE RANGE 



+127 -128, OR AS A BINARY NUMBER IN THE RANGE +255. NOW 

THE SUBTRACTION ABOVE SHOULD BE CLEAR ; INTERNALLY, THE MICRO- 
PROCESSOR ONE'S-COMPLEMENTS ONE OF THE NUMBERS AND THEN 
EXECUTES A NORMAL ADDITON WITH CARRY. 

1.4 BINARY CODED DECIMAL (BCD) ARITHMETIC 

99i6 LOOKS VERY LI KE 99io THEY BEHAVE THE SAME WAY AS THEY ARE 
MOVED AROUND AND UNDERGO LOGICAL OPERATIONS SINCE THEY ARE 
WRITTEN THE SAME WAY. THE BINARY REPRESENTATION OF 99io WOULD 
NORMALLYBE0110001l2,ANDOF99i6 IT WOULD BE 10011001,. WE NOW 
DEFINE THE BINARY CODED DECIMAL VERSION OF 99, AS BEING THE 
BINARY REPRESENTATION OF THE DECIMAL DIGITS IN THE ORIGINAL 
POSITIONAL NOTATION, MAKING THE DIFFERENCE BETWEEN THE BINARY 
REPRESENTATIONS OF 99,6 &99,o A MATTER OF SUPSCRIPTS: 

99,6 = 1001100I2 

99,0 = 10011001 B.C.D. 

THE B.C.D. AND BINARY NUMBERS DIFFER IN HANDLING ONLY IN 
ARITHMETIC: 

79,6 79io 

22,6 + BUT 22,0 + 

9Bi6 I0I1O 

THE MICROPROCESSOR CAN BE 'TOLD' WHICH TYPE OF ARITHMETIC TO 
CARRY OUT, BY SETTING (PUTTING A ONE INTO) OR CLEARING (PUTTING A 
ZERO INTO) AN INTERNAL BIT, THE 'DECIMAL MODE' FLAG. 



CHAPTER 2: WELCOME TO THE MACHINE 
2.1 HOW ACORN'S MICROPROCESSOR WORKS 

TO CARRY OUT THE ABOVE OPERATIONS THE MICROPROCESSOR HAS AN 
INTERNAL ARITHMETIC LOGIC UNIT (A.L.U.) WHOSE OUTPUT IS SENT TO AN 
INTERNAL REGISTER OF ONE BYTE LENGTH CALLED THE ACCUMULATOR 
'A', THIS REGISTER ALSO ACTS AS ONE OF THE OPERANDS; THE OTHER BEING 
DRAWN FROM THE MEMORY EXTERNAL TO THE /uPROCESSOR, WHICH IS CON- 
NECTED TO THE mP by 8 LINES CALLED THE DATABUS: 




DATA CAN BE TRANSFERRED ALONG THE DATABUS IN EITHER DIRECTION, 
THISDIRECTION IS CHOSEN BYTHE,/iPAND INDICATED TO THE EXTERNAL 
UNITS BY A SINGLE 'R/W' LINE : WHEN HIGH, '1' , THE )LiP IS RECEIVING DATA 
FROM THE MEMORY, 'READING'; WHEN LOW, '0', THE/izP ISSENDING DATA TO 
THE MEMORY, 'WRITING'. ALL INFORMATION USED BY THE juP TRAVELS 
ALONG THE DATABUS, INCLUDING THE INSTRUCTIONS. SO THAT THE /iP 
KNOWS WHERE ITS INSTRUCTIONS ARE IT HAS A TWO BYTE (16io BIT) 
REGISTER CALLED THE PROGRAM COUNTER, 'PC, WHICH POINTS AT THE 
INSTRUCTIONS BEING EXECUTED. THE MEMORY CAN BE VIEWED AS A BOOK 
OF 256 PAGES, THE PARTICULAR PAGE BEING DECIDED BY THE MOST 
SIGNIFICANTS BITS (BITS 15-8) OF THE 16 BIT ADDRESS, EACH PAGE CON- 
TAINING 256 BYTES, THE PARTICULAR BYTE BEING DECIDED BY THE LEAST 
SIGNIFICANT 8 BITS (BITS 7-0) OF THE 16 BIT ADDRESS. 



16 BIT ADDRESS >_ MEMORY <__^ ONE BYTE OF DATA 



IN THE KIT, PAGES FEie & FFie ARE OCCUPIED BY A NON-ERASEABLE PROGRAM 
TO INTERFACE BETWEEN THE MICROPROCESSOR AND THE KEYBOARD & 
DISPLAYUNIT.TOSTARTTHEmPINTHIS PROGRAM (AT THE CORRECT PLACE) 
THERE IS A RESET BUTTON WHICH INITIALIZES THE PROGRAM COUNTER. IN 
PAGE 00,6 THERE IS SOME ALTERABLE MEMORY, OF WHICH THE BOTTOM IFje 
BYTES ARE GIVEN SPECIAL USES BY THE FEi^ & FF,6 MONITOR PROGRAM, SO, 
UNLESS PRESSED FOR SPACE, IT'S BEST TO STAY OUT OF THEM. 



APPENDIX C HEXADECIMAL TO DECIMAL 
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400 


1024 


800 


2048 


1000 
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2000 


8192 


4000 


16384 


8000 


32768 


0000 


65536 



APPENDIX D ACORN MONITOR ADDRESS INFORMATION 

COMMENT 

LOW AND HIGH BYTES OF THE M ADDRESS 

LOW AND HIGH BYTES OF THE GO ADDRESS 

LOW AND HIGH BYTES OF THE BREAKPOINT ADDRESS 

LOW AND HIGH BYTES OF THE TAPE FROM ADDRESS 

LOW AND HIGH BYTES OF THE TAPE TO ADDRESS 

REGISTER 0: CONTAINS A AFTER BREAK. 

REGISTER 1 ; CONTAINS X AFTER BREAK. 

REGISTER 2: CONTAINS Y AFTER BREAK. 

REGISTER 3: TEMPORARI LY P AFTER BREAK, 

CONTAINS LAST PRESSED KEY FOR DISPLAY 

MSB=1 SETS REPEATEDLY SCANNED DISPLAY, 

OTHERWISE SINGLE SCAN. 

EXECUTION STATUS OF THE KEY PROCESSING 

ROUTINE 
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2.2 THE MONITOR COMMANDS M,t,| 

THE FIRST FEATURE OF THE MONITOR IS THE MEMORY INSPECT & MODIFY 

CONTROL SWITCH ON, AND PRESS THE RESET BUTTON: 



MODE 



ADDRESS 



DATA 



THEN PRESS THE MODIFY KEY, M. THIS GETS YOU INTO THE MEMORY 
INSPECTION AND MODIFY MODE. THE MODE INDICATOR SHOWS 'A' FOR 
ALTER. THIS Fl RST PHASE OF 'A' ALLOWS YOU TO CHOOSE ANY ADDRESS 
IN MEMORY. 

A. X X X X 

APPEARS ON THE DISPLAY, WHERE X REPRESENTS 
ANY OF THE 16 HEX CARACTERS SIGNIFYING THE ADDRESS.NOW PRESS THE 
KEYS F, E, 0, (IF YOU MAKE A MISTAKE, E.G. PRESSED F, D, JUST START 
OFF FROM THE F AGAIN). AS EACH KEY IS PRESSED THE INFORMATION 
ON THE DISPLAY SHIFTS TO THE LEFT: 



A. 
A. 
A. 
A. 



XXXF 
XXFE 
XF E0 
FE00 



AND SO YOU END UP WITH FE00 ON THE DISPLAY. PRESS ANY OF THE EIGHT 
COMMAND KEYS (IT DOES NOT MATTER WHICH) AND YOU CAN INSPECT THE 
CONTENTS OF THIS MEMORY ADDRESS. THIS IS PHASE TWO OF MODE 'A' AND 
ALLOWS YOU TO INSPECT AND ALTER THE DATA OF THE MEMORY ADDRESS 
CHOSEN IN PHASE ONE. 



FE00 



A0 



THIS IS THE INFORMATION STORED AT THE VERY BEGINNING OF THE 
MONITOR. IF YOU PRESS THE t KEY 

A. FE01 6 

UP WE GO. NATURALLYTHE i KEY BRINGS BACK 

A. FE00 A0 

AND EITHER KEY MAY BE USED ANY NUMBER OF TIMES IN SUCCESSION. NOW, 
IF, WITHOUT TURNING OFF, YOU PRESS RESET 



AND THEN M 



A. 



FE00 



THE SYSTEM HAS REMEMBERED THE ADDRESS YOU WERE USING (WHICH 
DOESN'T HAVE TO BE FE00) TO INSPECT MEMORY NOW ENTER THE ADDRESS 
0030 AND TERMINATE WITH ANY COMMAND KEY 



0030 



XX 



0030 IS AN ADDRESS IN THE ALTERABLE SECTION OF THE MEMORY. 
PRESSING DIGIT KEYS NOW WILL CAUSE THE INFORMATION IN 0030 TO 
CHANGE (WHAT HAPPENS AT FE00?? TRY IT! YOU CANNOT WRITE INTO THE 
MONITOR PROM, (i.e. THE PROGRAMMABLE READ ONLY MEMORY). PRESS 0, 1. 



A. 



0030 



01 



PRESS 2,3 



0030 



23 



AS BEFORE INFORMATION ISSHIFTED IN UNTIL TERMINATED BY ANY 
COMMAND KEY. BUT, UNLIKE THE ADDRESS FETCHING PHASE, THE COMMAND 
KEY WILL BE EXECUTED. USEFULTERMINATORS ARE THE M,t & J- KEYS. 
PRESS t. 



0031 



XX 



PRESS 4,5 



0031 



45 



PR ESS ; 



0030 



23 



& t AGAIN 



0031 



45 



YOU CAN GO UP AND DOWN INSPECTING & MODIFYING THE MEMORY 
CONTENTS IF THERE IS NO ALTERABLE MEMORY (E.G. A PROM) AT A 
PARTICULAR ADDRESS, THE INFORMATION WILL NOT CHANGE. TO CLOSE 
THIS SECTION WE'LL MAKE THE MONITOR DO A LITTLE TRICK. M,0,0,0,E, k 
( k = ANY COMMAND KEY) 
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PRESS 1,6. (IF YOU GET BORED, YOU CAN GO THE OTHER WAY BY 1,7) 
(ESCAPE BY RESET). THE MONITOR SCANS THROUGH ALL MEMORY 
SUCCESSIVELY SHOWING ITS CONTENTS (DATA). WHERE THERE IS NO 
MEMORY AT ALL YOU WILL PROBABLY SEE THE FIRST TWO ADDRESS 
DIGITS. 



2.3 AT LAST, A PROGRAM 

2.3.1 ASSEMBLY LANGUAGE, MACHINE LANGUAGE, THE INSTRUCTIONS 
LOAD, STORE AND JUMP 

A PROGRAM IS THE NAME FOR A SET OF STORED COMMANDS THAT THE 
MICROPROCESSOR WILL EXECUTE. THESE ARE STORED IN BINARY, SINCE 
THAT'S ALL THAT ANYTHING CAN BE STORED IN, (ENTERED BY YOU IN HEX) 
AND ARE INDISTINGUISHABLE FROM ANYTHING ELSE. IF IT GETS THE 
CHANCE THE /nP (MICROPROCESSOR) Wl LL BUSY ITSELF TREATING 
INFORMATION WHICH YOU MEANT AS DATA AS A PROGRAM. IT PROBABLY 
WONT BE DOING ANYTHING INTELLIGENT AND WILL HAVE TO BE 
SUMMONED BACK WITH THE RESET KEY. SOME SORT OF TRANSLATION 
BETWEEN THE STORED BINARY/HEX AND YOU IS NEEDED. 101011012 MEANS 
A GREAT DEAL TO THE/iP BUT LITTLE TO YOU. IT ACTUALLY MEANS "LOAD 
THE ACCUMULATOR WITH THE CONTENTS OF THE MEMORY ADDRESS 
DEFINED BY THE FOLLOWING TWO BYTES, C)F WHICH THE FIRST IS THE 
LEAST SIGNIFICANT ADDRESS". THIS ISA LITTLE LONG FOR WRITING 
STRAIGHT INTO A PROGRAM AND IS USUALLY ABBREVIATED TO LDA ABS, 
OR JUST LDA.ABSOLUTE MEANS ANYWHERE IN THE 64K. THE 6502 CAN 
ADDRESS 64K OF MEMORY WHICH IS DIVIDED INTO PAGES 256 BYTES LONG 
THE FIRST PAGE IS CALLED ZERO PAGE. LOCATIONS IN ZERO PAGE CAN 
BE ADDRESSED BY JUST ONE BYTE. THERE ARE SPECIAL INSTRUCTIONS TO 
DO THIS. AT THE END OF THE MANUAL THERE ISA LIST OF ALL THESE 
MNEMONICS WITH THEIR HEX EQUIVALENTS IN APPENDIX B. SO IF WE WROTE 
THE PROGRAM IN MNEMOMICS ITWOULD LOOK LIKE. 

LDA FE 00 
AND WE WOULD TRANSLATE IT FOR THE /iP AS THE THREE BYTES 

AD LOAD ABSOLUTE 

00 LOWER BYTE OF ADDRESS 

FE HIGH BYTE OF ADDRESS 
WHICH WOULD CAUSE THE mP TO PUT A0 (THE DATA STORED IN FE00) IN ITS 
ACCUMULATOR (REMEMBER USING THE MONITOR TO LOOK AT FE00?). THE 
TRANSLATION PROCESS IS CALLED ASSEMBLING AND COMPUTER PROGRAMS 
WHICH DO IT ARE CALLED ASSEMBLERS. A RESIDENT ASSEMBLER IS ONE 
THAT RUNS (OPERATES) ON THE SAME MACHINE THAT IT ASSEMBLES FOR; 
A CROSS ASSEMBLER RUNS ON A DIFFERENT MACHINE. THE MNEMONICS 
LDA, STA etc ARE OFTEN CALLED ASSEMBLY LANGUAGE, THE GENERATED 
BINARY IS CALLED MACHINE CODE. 

WE CAN LOAD THE ACCUMULATOR IN TEN OTHER WAYS; HERE ARE TWO OF 
THEM. 



INSTRUCTION 








LENGTH 








IN 






EXECUTION 


BYTES TYPE 


HEX 


MNEMONIC 


TIMEjuS BRIEF EXPLANATION 


2 1 


A9 


LDA# 


2 PUT THE NEXT BYTE 



A5 



AD 



LDA Z 



LDA 



ACCUMULATOR. "LOAD 
IMMEDIATE'. 
SHORTENED FORM OF 
LOAD ABS 00XX 'LOAD 
ZERO PAGE'. 
LOAD A ABSOLUTE. 



THE FIRST OF THESE INSTRUCTIONS IS VERY IMPORTANT. IF WE KNOW THAT 
WE WANT A0 IN THE ACCUMULATOR THEN IT IS WASTEFUL TO FIND A 
MEMORY LOCATION WHICH HAPPENS TO CONTAIN IT, SINCE TWO BYTES ARE 
NEEDED (GENERALLY) TO SPECIFY WHERE IT IS AND SO WE IMPLY, BY THE 
IMMEDIATE INSTRUCTION, WHERE IT IS & ACTUALLY ENTER IT IN THE 
PROGRAM. THERE ARE COMPLEMENTARY STORE ACCUMULATOR 'STA' 
INSTRUCTIONS TO LDA Z- AND LDA. 



BYTES 
2 



TYPE 
2 



HEX 
85 



MNEMONIC 
STAZ 



TIME/iS 
2 



STORE A ZERO PAGE 
(IN THE FIRST 256 BYTES) 
3 3 8D STA 3 STORE A ABSOLUTE 

(ANYWHERE IN MEMORY) 
WE CAN ALSO LOAD THE PROGRAM COUNTER. THE PROGRAM COUNTER IS AN 
INTERNAL REGISTER THAT POINTS TO THE NEXT LINE OF THE PROGRAM. 
THE MNEMONIC FOR THIS IS NOT LDPC BECAUSE WHEN THE P.C. IS LOADED 
WITH A NEW VALUE IT GIVES THE MICROPROCESSOR A DIFFERENT PLACE TO 
LOOK FOR INSTRUCTIONS: THE PROGRAM JUMPS. SO 'LOAD P.C. WITH NEXT 
TWO BYTES' (LDPC ) IS JMP, THIS IS REFERRED TO AS JUMP ABSOLUTE 
SINCE THE PROGRAM JUMPS TO A NEW ABSOLUTE ADDRESS. SO IF WE ARE 
NOT IN THE MONITOR AND WANTTO BE, JMP FF04WILL ENTER THE MONITOR. 
NOW WHAT HAPPENS IF THE FOLLOWING PROGRAM IS RUN? 

LDA FE00 

STA Z 20 

JMP FF04 

THE FIRST INSTRUCTION GETS THE CONTENTS OF FE00, AND PUTS IT IN THE 
ACCUMULATOR. THE SECOND STORES THE ACCUMULATOR IN LOCATION 
0020.THE FIRST TWO 0'S REFER TO ZERO PAGE AND ARE ASSUMED BY THE 
PROCESSOR IN THE ZERO PAGE MODE. THE THI RD GETS BACK TO THE 
MONITOR, SO THAT YOU CAN INSPECT LOCATION 20. THIS READS AS. 



0030 


AD (OPCODE) 


LDA FE00 


0031 


00 (DATA) 




0032 


FE (DATA) 




0033 


85 (OPCODE) 


STA Z 20 


0034 


20 (DATA) 




0035 


4C (OPCODE) 


< JMP FF04 


0036 


04 (DATA) 




0037 


FF (DATA) 





II RELATIVE: RELATIVE ADDRESSING MODE 

2 BYTES 2+t CYCLES 



MNEMONIC 


VERBAL 






BCC 


BRANCH IF CARRY CLEAR 


90 


BRANCH IF C = 


BCS 


BRANCH IF CARRY SET 


B0 


C=1 


BEQ 


BRANCH IF EQUAL (TO ZERO) 


F0 


Z=1 


BMI 


BRANCH IF MINUS 


30 


N=1 


BNE 


BRANCH IF NOT EQUAL 


D0 


Z = 


BPL 


BRANCH IF PLUS 


10 


N =0 


BVC 


BRANCH IF OVERFLOW CLEAR 


50 


V = 


BVS 


BRANCH IF OVERFLOW SET 


70 


V=1 
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THE ADDRESS 0030 IS THE STARTING ADDRESS OF THE PROGRAM. THIS 
PARTICULAR PROGRAM Wl LL WORK WITH ANY STARTING ADDRESS - IT IS 
SAID TO BE 'POSITION INDEPENDENT' OR 'RELOCATABLE' - BUT OTHER 
PROGRAMS MAY NOT. IF YOU ARE NEW TO THE GAME, IT WILL BE EASIER IF 
YOU ENTER PROGRAMS AT THE STARTING ADDRESS SHOWN IN THE MANUAL. 

2.3.2 ENTERING A PROGRAM, THE GO COMMAND 

TO ENTER THIS PROGRAM, WE'LL GO THROUGH IT STEP BY STEP. 
I 



ENTER THE STARTING ADDRESS: PRESS M,0.0,3,0, k 

ENTER A BYTE OF DATA A,D 

USE THE t KEY TO TERMINATE DATA ENTRY AND STEP UP 

- CONTINUE WITH 0,0,t,F,E,t,8,5,t,2,0,t,4,C,t,0,4,t,F,F 
CHECK THAT THE PROGRAM IS ENTERED CORRECTLY BY, E.G, USING 4- 
TO GO BACK DOWN THROUGH IT. 

- REMEMBER THAT MISTAKES AT KEY ENTRY (E.G. PRESSED 8,6) MAY BE 
CORRECTED BY CONTINUING (PRESS 8,5) - 

NOW THAT THE PROGRAM IS LOADED PRESS ONLY ONCE THE 'GO' (G) KEY 



II 



IV 



K. 



XXXX 



APPEARS THE K ( R.) REMINDS YOU OF TWO THINGS: J- THIS IS A DIFFERENT 
STORED ADDRESS TO THE A. ADDRESS. IL YOU CAN'T GO BACK! (UNLESS 
YOU EITHER PRESS RESET OR ENTER ADDRESS FF04.THE MONITOR ENTRY 
ADDRESS. AND GO) THE NEXT COMMAND KEY YOU PRESS Wl LL CAUSE THE 
juP TO DO A KAMI-KAZE DIVE TO THE ADDRESS SHOWN, SO ITS AS WELL TO 
GET IT RIGHT!! ENTER 0,0,3,0 



K. 



0030 



AND PRESS ANY COMMAND KEY. NOTHING HAPPENED? WELL IT DID, REALLY. 
IT JUST HAPPENED VERY QUICKLY: 

PROGRAM EXECUTION TIMES,mS 

LDA FE00 4 

STA Z 20 3 

JMP FF04 3 

TOTAL 1010 mS 
ITTOOKTENMILLIONTHSOFASECONDTO HAPPEN. WE'RE NOW BACK IN 
THE MONITOR. PRESSING ANY DIGIT KEY WILL CAUSE THE (BY NOW) 
FAMILIAR DOTS TO REAPPEAR. PRESS M,0 ,0,2,0 k : 



0020 



A0 



WHICH CHECKS THAT THE PROGRAM ACTUALLY DID WORK. YOU COULD 
CHANGE 0020 AND RUN THE PROGRAM AGAIN BY THE KEYS 

F, F,G,G,M, M 
WHICH SUCCESSIVELY PUT FF IN 0020, RUN THE PROGRAM AND RE-EXAMINE 



LOCATION 0020. A LOT QUICKER FOR YOU THE SECOND TIME, WASN'T IT? 
THIS ISBECAUSEM&G REMEMBER WHAT THEY WERE POINTING AT. LET'S 
MAKE THE PROGRAM BETTER. AT THE MOMENT WE HAVE NO IDEA IF IT RAN, 
AND WE DON'T KNOW IF IT RAN CORRECTLY UNTIL WE LOOK AT 0020. IF THE 
PROGRAM WROTE OUT THE BYTE ON THE DISPLAY AS WELL AS STORI NG IT 
IN 0020, WE'D KNOW THAT IT HAD ALL HAPPENED. INSIDE THE ACORN 
MONITOR PROGRAM IS A SET OF INSTRUCTIONS TO WRITE A BYTE ONTO THE 
TWO RIGHT HAND DISPLAY DIGITS. THIS PROGRAM IS LOCATED AT FE60 AND 
EXPECTS THE BYTE TO BE DISPLAYED TO BE IN THE ACCUMULATOR, WHICH 
IT IS. THE PROGRAM DESTROYS THIS BYTE AS IT PUTS IT ONTO THE DISPLAY 
SO WE MUST PUT IT IN 0020 BEFORE USING THE PROGRAM. 
2.3.3 INSTRUCTIONS JMP, JSR 

IF WE SIMPLYWENTJMPFE60THISWOULD CORRECTLY EXECUTE THE 
PROGRAM BUT WE WOULD BE LEFT IN THE MIDDLE OF THE MONITOR SOME- 
WHERE SINCE THE PROGRAM DOES NOT HAVE AN ADDRESS TO JUMP BACK 
TO. WE CAN GIVE IT SUCH AN ADDRESS WITH THE INSTRUCTION JSR (OPCODE 
20 HEX) THIS IS EXACTLY LIKE A JUMP BUT IT SAVES THE PROGRAM 
COUNTER BEFORE JUMPING. THEN THE SINGLE BYTE INSTRUCTION RTS 
(OPCODE 60 HEX) RESTORES THE PROGRAM COUNTER AND WE GET BACK 
AGAIN. JSR IS "JUMP TO SUBROUTINE" AND RTS IS "RETURN FROM 
SUBROUTINE". THE PROGRAM AT FE60 HAS AN RTS ATTACHED AT ITS END, 
ANDSOCANTRANSFERCONTROLBACKTOTHE PROGRAM WHICH CALLED IT. 
OUR NEW PROGRAM IS 3 BYTES LONGER: 



APPENDIX A 

64 CHARACTER ASCII ON ACORN'S 7 SEGMENT DISPLAY 



0030 
0031 
J032 
0033 
0034 
0035 
0036 
0037 
0038 
0039 
003A 



AD 

00 

FE 

85 

20 
"20 

60 

FE 
'4C 

04 / 

-J 



LDA FE00 

STA Z 20 
JSR FE60 

JMP FF04 



AND WE Wl LL HAVE TO ENTER 6 BYTES FROM 0035 TO 003A WITH 

M,0,0,3,5, k , 2,0, t,6,D,t,F,E,t,4,C,t,0,4,t,F,F. WE HAVEN'T CHANGED THE START 

OF THE PROGRAM SO G, G WILL RUN IT. 



ASCII CODE 


DISPLAY 


CHARACTER 


HEX 


ASCII CODE 


DISPLAY 


CHARACTER 


HEX 





a 


@ 


5F 


20 






00 


1 


n 


A 


77 


21 


1. 


! 


86 


2 


b 


B 


7C 


22 


1 1 


tt 


22 


3 


c 


C 


58 


23 


□ 


# 


63 


4 


d 


D 


5E 


24 


c 


£ 


3B 


5 


E 


E 


79 


25 


l— 


% 


2D 


6 


F 


F 


71 


26 


E 


& 


7B 


7 


G 


G 


3D 


27 


1 


■ 


02 


8 


h 


H 


34 


28 


C. 


( 


B9 


9 


_i 


1 


05 


29 


Zl. 


) 


8F 


A 


_j 


J 


0D 


2A 


H 


* 


76 


B 


R 


K 


75 


2B 


_i 


+ 


42 


C 


L 


L 


38 


2C 


1 


, 


04 


D 


n 


M 


37 


2D 


— 


— 


40 


E 


n 


N 


54 


2E 


. 




80 


F 


D 





5C 


2F 


H 


/ 


52 


10 


P 


P 


73 


30 


D 





3F 


11 


R 


Q 


67 


31 


1 


1 


06 


12 


r— 


R 


50 


32 


E 


2 


5B 


13 


5. 


S 


ED 


33 


3 


3 


4F 


14 


t 


T 


78 


34 


H 


4 


66 


15 


1 1. 


U 


9C 


35 


5 


5 


6D 


16 


L_l 


V 


1C 


36 


B 


6 


7D 


17 


y 


w 


7E 


37 


n 


7 


07 


18 




X 


49 


38 


B 


8 


7F 


19 


y 


Y 


6E 


39 


B 


9 


6F 


1A 


p, 


z 


BD 


3A 


1 




82 


IB 


c 


[ 


39 


3B 


1. 


) 


84 


1C 


H 


\ 


64 


X 


H 


< 


46 


ID 


Zl 


] 


0F 


3D 


— 


= 


48 


IE 


1 — 1 


A 


23 


3E 


1- 


> 


70 


IF 


__ 


— 


08 


3F 


P. 


? 


D3 



K. 



0030 



A0 



APPEARS MEANING THAT 0020 HAS AGAIN HAD A0 WRITTEN INTO IT. 
INSTEAD OF STORING THINGS IN 0020, LET'S USE ITS INFORMATION AS PART 
OF A LOGICAL OPERATION. 



PROGRAM. THE STRATEGY OF THE PROGRAM IS NOT OBVIOUS, AND IS LEFT 
AS AN EXERCISE TO THE READER. A SMALL PRIZE WILL REWARD THE 
SUBMISSION OF A SHORTER, FASTER PROGRAM; NOTE THAT WORKSPACE 
REQUIREMENTS CONTRIBUTE TO THE LENGTH! 

8 QUEENS PROGRAM 



mm 


F8 




0201 


A2 


20 


0203 


84 


IF 


0205 


84 


20 


0207 


84 


29 


0209 


84 


32 


020B 


20 


16 02 


020E 


A5 


IF 


0210 


20 


60 FE 


0213 


4C 


04 FF 


0216 


B5 


00 


0218 


C9 


FF 


021A 


D0 


07 


021C 


A5 


IF 


021 E 


69 


00 


0220 


85 


IF 


0222 


60 




0223 


15 


09 


0225 


15 


12 


0227 


A8 




0228 


49 


FF 


022A 


F0 


F6 


022C 


95 


18 


022E 


C8 




022F 


98 




0230 


35 


IB 


0232 


A8 




0233 


15 


00 


0235 


95 


01 


0237 


98 




0238 


15 


09 


023A 


0A 




023B 


95 


0A 


023D 


98 




023E 


15 


12 


0240 


4A 




0241 


95 


13 


0243 


E8 




0244 


20 


16 02 


0247 


CA 




0248 


B5 


01 


024A 


49 


FF 


024C 


35 


IB 


024E 


49 


FF 


0250 


4C 


27 02 


0253 







MAIN 



TRY 



FINISH 



LOOP 



SED 

LDX #20 
STY COUNT 
STY ROW 
STY LEFT 
STY RIGHT 
JSR TRY 
LDA COUNT 
JSR RDHEXTD 
JMP RESTART 
LDA2X 00 
CMP#FF 
BNE CONTINUE 
LDA COUNT 
ADC #00 
STA COUNT 
RTS 

ORAZX 09 
ORAZX 12 
TAY 

EOR#FF 
BEQ FINISH 
STAZX IB 
INY 
TAY 

ANDZX1B 
TVivY 
CRAZX 00 
STAZX 01 
TYA 

ORAZX 09 
ASLA 
STAZX 0A 
TYA 

ORAZX 12 
LSRA 
STAZX 13 
INX 

JSR TRY 
DEX 

LDAZX 01 
EOR#FF 
ANDZX IB 
EOR#FF 
JMP LOOP 



- CLEAR COUNT 

- CLEAR ROW OCCUPIED 

- CLEAR LEFT DIAGONAL ATTACKS 

- CLEAR RIGHT DIAGONAL ATTACKS 

- FIND THE NO OF WAYS 

- DISPLAY ANSWER 

- FINISHED YET? 

- FINISHED.SO INCREMENT COUNT 



CURRENT LEFT 
CURRENT RIGHT 



NO CHANCE 

CURRENT POSSIBLE PLACE 



NEW ROW 



NEW LEFT ATTACK 



- NEW RIGHT ATTACK 



2.3.4 THE LOGIC INSTRUCTIONS 'ORA', 'AND', 'EOR'. 

IF WE PUT 6016 IN LOCATION 0020 (M,0,0,2,0, k, ,6,0 : YOU SHOULD KNOW BY 
NOW) AND ALTER THE STA 2 INSTRUCTION AT 0033 TO, SAY, ORA Z {OPCODE 
05 HEX) (THE PROGRAM READS LDA FE00 

ORA Z20 

JSR FE60 

JMP FFa4) 
WE HAVE A PROGRAM THAT DISPLAYS THE LOGICAL 'OR' BETWEEN THE 
CONTENTS OF FE00 (A0) AND 0020, (60). THE HEX FOR ORA Z IS 05 AND IT 
CARRIES OUT A LOGICAL 'OR' BETWEEN THE ACCUMULATOR AND THE 
SPECIFIED LOCATION IN Z PAGE. M,0,0,3,3, k 0,5 IS THE MODIFICATION 
TO THE PROGRAM,THEN SINCE WE STILL START AT 0030, G,G RUNS IT : 



K. 



0030 



E0 



THE OPERATION WAS 'OR' 



A0 
60 
E0 



or 



10100000 
01100000 or 
111 



TRY CHANGING 0020 TO 40 AND RUNNING THE PROGRAM AGAIN IS THE 
ANSWER WHAT YOU EXPECTED? 

WE CAN CHANGE 0033 TO MAKE THE PROGRAM DO LOGICAL 'AND' OR 
'EXCLUSIVE - OR'. THE MNEMONICS AND OPCODES ARE: 



AND 



25i, 



EOR 



45 



16 



LOGICAL AND ACCUMULATOR AND Z PAGE 
MEMORY 

LOGICAL EXCLUSIVE-OR ACCUMULATOR AND 
E PAGE MEMORY 
AND THE PROGRAMS WOULD READ 

LDA FE00 & LDA FE00 

AND Z 20 EOR Z 20 

JSR FE60 JSR FE60 

JMP FF04 JMP FF04 

BY NOW YOU MUST BE GETTING Tl RED OF THE A0 IN FE00 SO WE'LL CHANGE 
THE PROGRAM TO READ 

LDA Z21 

EOR Z20 

JSR FE60 

JMP FF04 
THE SPACE TAKEN UP BY LDA Z 21 IS ONE BYTE LESS THAN THAT USED BY 
LDA FE00. WE COULD SIMPLY WRITE THE NEW TWO BYTES IN AT LOCATIONS 
0031 & 0032 AND CHANGE THE GO ADDRESS TO 0031. THIS IS VERY SIMPLE 
HERE SINCE THAT IS ALL WE HAVE TO DO. BUT IF THERE WERE MANY 
REFERENCES TO 0030 AS THE START OF THIS PROGRAM IT WOULD TAKE A 
LONG TIME TO FIND AND CHANGE THEM ALL, AND IF WE DIDN'T CHANGE 
THEM ALL SOMETHING WOULD GO WRONG. WE CAN'T MOVE THE REST OF 
THE PROGRAM DOWN ONE BYTE: SOMETHING MIGHT BE REFERRING TO IT. 
THE PROBLEM ARISES BECAUSE LDA Z IS SHORTER THAN LDA. WE COULD 
SIMPLY USE LDA WITH A ZERO PAGE ADDRESS BUT THIS TAKES A WHOLE jxS 



LONGER THAN LDA 2! THE SOLUTION IS TO USE LDA Z AND TO INCORPORATE 
AN EXTRA BYTE IN 0030 AS PADDING. THIS MUST BE A SINGLE-BYTE 
INSTRUCTION, THAT DOES NOTHING TO AFFECT THE PROGRAM, AND ONE IS 
SPECIFICALLY PROVIDED 



'NO OPERATION" 



NOP EA 
THE PROGRAM READS 

0030 EA NOP 

0031 A5 21 >,r| LDA Z 21 
0033 45 20,,.---" ^ EOR Z 20 
0035^g0FE JSR FE60 
0038 4C04FF JMP FF04 

-NOTICE THE MORE COMPACT MODE OF WRITING IT DOWN. THIS IS MORE 
CONSISTENT WITH THE WAY MNEMONICS ARE WRITTEN. IT IS EXACTLY 
EQUIVALENT TO 

0030 EA NOP 

0031 A5 LDA Z 21 

0032 21 

0033 45 EOR Z 20 

0034 20 

0035 20 JSR FE60 

0036 60 

0037 FE 

0038 4C JMP FF04 

0039 04 
003 A FF 

AND (TWILL BE USED THROUGHOUT THE REST OF THE MANUAL: 
THIS PROGRAM TAKESTHE CONTENTS OF (WHICH MAY BE WRITTEN BY 
PUTTING BRACKETS AROUND THE PARTICULAR ADDRESS) 0020 & 0021 AND 
PRESENTS THEIR LOGICAL EXCLUSIVE - OR ON THE DISPLAY. APART FROM 
THEIR LOGICAL FUNCTIONS, THESE OPERATORS ARE OFTEN USED TO 
MANIPULATE SINGLE BITS. FOR INSTANCE OR A #01 WOULD SET BIT OF THE 
ACCUMULATOR, AND # FE WOULD CLEAR IT AND EOR #01 WOULD COMPLENT 
IT, ALL WITHOUT AFFECTING ANY OTHER BITS IN THE ACCUMULATOR. 



2.3.5 ARITHMETIC INSTRUCTIONS 'ADC, 'SEC, 'CLC. 

FROM LOGIC OPERATIONS WE PROGRESS AGAIN TO ARITHMETIC. LOOKING 
AT ORA Z, EOR Z, AND 2 WOULD LEAD ONE TO ASSUME THE EXISTENCE OF 
ADD Z. WELL, THERE ISN'T ONE, THERE'S ONLY ADC Z. 
BYTES: 2 ADC Z 65 "ADD WITH CARRY, ZERO PAGE" 

1 SEC 38 "SET CARRY FLAG" 

1 CLC 18 "CLEAR CARRY FLAG" 

THIS IS MOST UNUSUAL AND A TRAP FOR UNWARY PROGRAMMERS, 
ESPECIALLY THOSE USED TO mPs WHICH POSSESS AN ADD INSTRUCTION: THE 
CARRY FLAG MUST BE CLEARED BEFORE AN ADC (OR IT MUST BE IN A 
KNOWN STATE E.G. f SEC = f CLC 

1 ADC #00 1 ADC #01 OR 

'UNEXPECTED' ANSWERS Wl LL APPEAR. WHEN THE juP LEAVES THE MONITOR 
USING THE GO ROUTINE THE CARRY FLAG IS SET: FAILURE TO CLEAR IT 
BEFORE AN ADC RESULTS IN AN ANSWER 1 GREATER THAN EXPECTED. 



THE METRONOME PRODUCES A PULSE AT THE TAPE OUTPUT PIN, PA6, WITH A 
REGULAR PERIOD. THE "UP" AND "DOWN" KEYS WILL INCREASE AND 
DECREASE THE PERIOD RESPECTIVELY. WITH SUITABLE ADDITIONAL 
CIRCUITRY THIS COULD DRIVE A LOUDSPEAKER OR A 'STROBE' LIGHT. IN 
FACT A SMALL SOUND CAN BE OBTAINED BY SIMPLY CONNECTING A LOUD- 
SPEAKER ACROSS THE TAPE OUTPUT AND EARTH PINS. 

THE CONSTANTS USED AT PRESENT MEAN THAT THE PULSE IS OF 1/300 SEC. 
AND THE DELAY BETWEEN PULSES CAN BE VARIED FROM 1/20 SEC. TO 
ABOUT 13 SECS. YOU CAN DEFINE THE PERIOD BEFORE STARTING THE 
PROGRAM BY PUTTING THE REQUIRED VALUE INTO MEMORY LOCATION 
0020. 20 Wl LL GIVE ABOUT 1 SEC BETWEEN PULSES, AND ANYTHING ELSE 
PROPORTIONATELY MORE OR LESS. ONCE THE PROGRAM IS RUNNING THE 
'UP' AND 'DOWN' KEYS WILL INCREMENT AND DECREMENT THE PERIOD BY 
ABOUT 1/20 SEC EACH TIME THEY ARE PRESSED. THEY ALSO RESET THE 
CYCLE. THIS FACILITY COULD USEFULLY BE USED FOR FINE TUNING BUT 
WOULD BE TEDIOUS FOR LARGE CHANGES OF PERIOD. 

METRONOME 



ftDDR 


HEX 




LABEL 


INSTRUCTION 


COMMENTS 




CODE 










(xzm 


A9 


IF 






LDA#1F 




0202 


85 


0E 






STA REPEAT 


- SET DISPLAY TO SINGLE SCAN 


0204 


A9 


40 




PULSE 


LDA #40 




0206 


8D 


22 


0E 




STA1ADDR 


- DEFINE PA6 AS OUTPUT 


0209 


8D 


16 


0E 




STA SET PI A6 


- USE INS8154 SET BIT MODE 


020C 


20 


CD 


FE 




JSR WAIT 


- USE THE 300 BAND WAIT 


020F 


8D 


0)6 


0E 




STA CLR PIA6 


- USE IN58154 CLEAR BIT MODE 


0212 


A6 


20 






LDXZ PERIOD 




0214 


20 


0C 


FE 


DELZ 


JSR DISPLAY 


- LOOK AT KEYBOARD 


0217 


C9 


16 






CMP #16 


- UP KEY? 


0219 


D0 


04 






BNE DOWN 


- NO 


021 B 


E6 


20 






INCH PERIOD 


- INCREASE PERIOD 


021 D 


B0 


E5 






BCS PULSE 


- CARRY WAS SET BY THE COMPARE 
ALWAYS 


021 F 


C9 


17 




DOWN 


CMP #17 


- DOWN KEY? 


0221 


D0 


04 






BNE DELI 


- NO 


0223 


C6 


20 






DEC^ PERIOD 


- DECREASE PERIOD 


0225 


B0 


DD 






BCS PULSE 


- CARRY WAS SET BY THE COMPARE 
ALWAYS 


0227 


A0 


0C 




DELI 


LDY #0C 


- CYCLE TIME OF /i 720 SEC. 


0229 


20 


CD 


FE 


DELJ 


JSR WAIT 




022C 


88 








DEY 




022D 


10 


FA 






BPLDELJ 




022F 


CA 








DEX 




0230 


D0 


E2 






BNE DEL2 




0232 


F0 


D0 






BEQ PULSE 


- END OF THIS PERIOD SO PULSE 


0234 















THE EIGHT QUEENS PROBLEM IS TO FIND THE NUMBER OF WAYS IN WHICH 
EIGHT QUEENS MAY BE PLACED ON A CHESS BOARD WITHOUT ATTACKING 
EACH OTHER. THE PROGRAM FINDS 92 WAYS SINCE IT COUNTS ROTATIONS 
AND REFLECTIONS, ALLPOSSIBLE POSITIONS ARE TRIED AS SOLUTIONS IN 
THIS HIGH SPEED RECURSIVE (I.E. IS DEFINED IN TERMS OF ITSELF) 



COUNTER KEYBOARD 



ADDR 


HEX 






LABEL 


INSTRUCTION 


COMMENTS 




CODE 






















- START OF 001 C 


001 D 


20 


0C 


FE DISP 


JSR DISPLAY 


- LOOK FOR KEY 


0020 


90 


0A 






BCC CHANGE 


- CHECK IF CONTROL KEY CARRY 
SET IF SO 


0022 


C9 


07 






CMP #'07 




0024 


F0 


1F 






BEQ DOWN 




0026 


C9 


06 






CMP# 06 




0028 


F0 


11 






BEQ UP 




002A 


D0 


F1 






BNE DISP 




002C 


C9 


00 




CHANGE 


CMP# 00 




002E 


85 


19 






STA COUNT 




0030 


F0 


ED 




MORE 


BEQ DISP 




0032 


20 


60 


m 




JSR INCR 




0035 


C6 


19 






DEC COUNT > 


INCREMENT NO OF TIME OF TEY 


0037 


10 


F7 






BPLMORE 




0039 


30 


E2 






BMI DISP 




003B 


20 


60 


m 


UP 


JSR INCR -^ 




003E 


20 


45 


00 




JSR ZOOM 




00N 
0041 


D0 


CF 






BNE DISP r 


RAPID INCREMENT 


0043 


F0 


F6 






BEQ UP ^ 




0045 


20 


69 


00 


DOWN 


JSR DECR >, 




0048 


20 


4F 


00 




JSR ZOOM 




004B 


D0 


D9 






BNE DISP ? 


RAPID INCREMENT 


004D 


F0 


F6 






BEQ DOWN j 




004F 


A9 


IF 




ZOOM 


LDA#1F 




0051 


85 


0E 






STA0E 


SET FOR ONE SCAN ONLY 


0053 


20 


00 


FE 




JSR DISPLAY 




0056 


90 


03 






BCC STOP 


CHECK IF KEY DEPRESSED CLEAR 
IF ONE IS 


0058 


A9 


00 






LDA# 00 




005A 


60 








RTS 




005B 


A9 


FF 






LDA# FF 


RESET SO THAT JSR DISPLAY 
WAITS FOR INPUT 


005D 


A9 


FF 






LDA# FF 




005D 


85 


0E 






STA0E 




005F 


60 








RTS 




COUNTER SUBROUTINE 






ADDF 


i HEX 
CODE 




LABEL 


INSTRUCTION 


COMMENTS 


0060 


F6 


1A 




INCR 


INCCNTL 




0062 


D0 


0D 






BNE UPDATE 




0064 


E6 


IB 






INCCNTH 




0066 


38 








SEC 




0067 


B0 


08 






BCS UPDATE 




0069 


A5 


1A 




DECR 


LDA CNTL 




0063 


D0 


02 






BNE NOT 




006D 


C6 


IB 






DEC CNTH 




006F 


C6 


1A 




NOT 


DEC CNTL 




0071 


A2 


1A 




UPDATE 


LDX#IE 




0073 


20 


64 


FE 


JSR QHEXTD1 




0076 


60 








RTS 





ANOTHER TRAP FOR THOSE USED TO DIFFERENT MPs IS THE DECIMAL FLAG. 
INSTEAD OF A SINGLE "DECIMAL ADJUST" INSTRUCTION TO ADJUST THE 
RESULT OF BINARY ARITHMETIC ON B.C.D. NUMBERS TO B.C.D. THERE ARE 
TWO INSTRUCTIONS 
BYTES: 1 SED F8 "SET DECIMAL MODE" 

1 CLD D8 "CLEAR DECIMAL MODE" 

WHICH INSTRUCT THE PROCESSOR TO DO AUTOMATICALLY (OR NOT DO) THE 
ADJUSTMENT AFTER ARITHMETIC OPERATIONS. THIS RESULTS IN SHORTER, 

FASTER PROGRAMS FOR HANDLING B.C.D. ARITHMETIC WHICH, MERELY 

BY CHANGING THE DECIMAL MODE FLAG, WILL HANDLE BINARY ARITHMETIC. 
IN ORDER TO FULLY UTILISE THE MP's POWER THE MONITOR SUBROUTINES 
FOR FETCHING KEYS & OUTPUTTING DATA TO THE DISPLAY HAVE BEEN 
WRITTEN WITHOUT ARITHMETIC SO THEY MAY BE CALLED WITH THE 
DECIMAL FLAG SET OR CLEARED & THEY Wl LL NOT AFFECT IT. 
SO LET'S DO A DECIMAL ADDITION; 

SED 

CLC 

LDA Z 21 

ADC Z 20 

JSR FE60 

JMP FF04 
OUR STANDARD PROGRAM HAS BEEN EXTENDED BACKWARDS BY ONE BYTE, 

THE SED INSTRUCTION. THIS SHOULD BE INCLUDED (BY, 0,02,F,0re- ,^ 

THE FIRST TIME THE PROGRAM IS RUN, BUT MAY BE OMMITTED (K,0,0,3,0,4) 
ON SUBSEQUENT RUNS. THIS LITTLE PROGRAM Wl LL TELL US THAT 
22 + 1 1 = 33, IT Wl LL SAY THAT 35 + 26 = 61 AND THAT 50 + 51 = 01 WHOOPS! 
THE PROGRAM AT FE60 ONLY DEALS WITH PUTTING THE BYTE IN THE 
ACCUMULATOR ON THE DISPLAY. IT PAYS NO ATTENTION TO THE CARRY 
FLAG, INDEED IT CHANGES THE STATE OF THE CARRY FLAG ITSELF, SO 
THAT WE CANT IMMEDIATELY CALL FE60, HAVE ITWRITEONTHE DISPLAY 
& RETURN THEN WRITE OUT THE STATE OF THE CARRY SOMEHOW.WHAT WE 
NEED IS: 

I SAVE THE CARRY FLAG 

II USEFE60 

III GETTHE CARRY FLAG BACK & WRITE IT OUT SOMEHOW 

A FRENZIED SEARCH THROUGH THE MNEMONICS REVEALS THAT THERE ARE 
NO MNEMONICS LIKE LDC (LOAD C) OR STC (STORE C) 
A CLOSER LOOK AT THE MICROPROCESSOR IS REQUIRED. 



002F 


F8 


0030 


18 


0031 


A5 21 


0083 


65 20 


0035 


20 60FE 


0038 


4C04FF 



CHAPTER 3: INSIDE THE 6502 

SO FAR THE PROCESSOR'S INTERNAL WORKINGS ARE 

3.1 THE ACCUMULATOR, PROGRAM COUNTER, STATUS REGISTER 

7 BIT NUMBER 

I A I ACCUMULATOR 

15 

I PC I PROGRAM COUNTER 



fcl CARRY FLAG 

fol DECIMAL MODE FLAG 



THE CARRY & DECIMAL MODE FLAGS HAVE BEEN TREATED SEPARATELY TO 
DATE. THEY ARE ACTUALLY MEMBERS OF A SPECIAL REGISTER CALLED THE 
PROCESSOR STATUS REGISTER.P. 







V 



D 



INTERRUPT DISABLE 
ZERO (THIS FLAG 1 WHEN 

SOMETHING HAS BECOME 00) 



— CARRY 



DECIMAL FLAG 

BREAK COMMAND EXECUTED 

OVERFLOW 
NEGATIVE 



CAN WE, THEN, USE LDP & STP? NO, THEY DON'T EXIST EITHER. (FUME). IN 
ORDER TO SOLVE THIS PROBLEM A/E MUST INTRODUCE THE STACK. 
DID YOU WONDER JUST WHAT HAPPENED TO PC DURING A JSR? YOU WERE 
TOLD THAT IT WAS 'SAVED'. WHERE? HOW? IT WOULD BE TERRIBLE TO HAVE 
TO SPECIFY WHERE IT HAD TO BE STORED. WHAT'S NEEDED IS SOME PLACE 
WHERE IT CAN BE PUT DOWN AND PICKED UP AGAIN. IT WOULD BE GOOD TO 
ALLOW NESTED SUBROUTINES: 



ADDR HEX 

CODE 
0213 95 1(9 
0215 A9 61 

CA 

10 02 



0217 
0218 



LABEL 



INSERT 



OLDX 



021A A2 07 

021C 95 10 

021 E 86 20 

0220 A2 0E 



0222 20 0C FE WAIT 

0225 C5 20 

0227 F0 05 

0229 CA 
022A D0 F6 
022C F0 El 

022E A9 1C HIT 

0230 A6 20 
0232 95 10 
0234 A9 FF 
0236 85 0E 
0238 20 0C 
023B 90 C3 '^ 
023D 4C 04 FF 
023F 



Q 



INSTRUCTION 

STA Z X 10 
LDA#DUCK 
DEX 
BPLOLDX 

LDX #07 
STAZ X10 
STX H 20 
LDX #TIME 

JSR DISPLAY 

CMP 2 20 

BEQ HIT 

DEX 

BNEWAIT 

BEQ REMOVE 

LDA #DEAD DUCK 

LDX H 20 

STAZ X 10 

LDA#F,F, 

STJ^' H 0§ 

JSFl DISPLAY 

BCC BEGIN 

JMP RESTART 



COMMENTS 



PUT NEW DUCK ON 

IN NEW POSITION 

BUT NOT OVER THE END OF THE 

DISPLAY 



- DISPLAY INTERVAL IS SET BY THE 
BYTE LOADED INTO X 

- HIT? 



FINISHED WAIT TIME 
PUTIN A DEAD DUCK 



Fi 



TEST FOR CONTINUATION 
OR BACK TO THE MONITOR 



\ 



MISCELLANEOUS 
1 

THE COUNTER PROGRAM COULD BE USED AS A SUBROUTINE IN A LONGER 
PROGRAM WHEN "JSR INCR" AND "JSR DECR" WOULD INCREMENT OR 
DECREMENT THE DISPLAY. IF THE PROGRAM APPENDED IS ALSO ENTERED 
THE DISPLAY WILL INCREASE OR DECREASE RAPIDLY IF "UP" OF "DOWN" 
KEYS ARE DEPRESSED. THIS Wl LL BE STOPPED BY ANY HEX KEY. IT WILL 
INCREMENT BY THE INDICATED AMOUNT IF KEYS 1-F ARE DEPRESSED AND 
WILL IGNORE ALL OTHER KEYS. 

YOU SHOULD PARTICULARLY NOTICE THAT A JSR DISPLAY RETURNS WITH 
THE CARRY BIT CLEAR AND THE ACCUMULATOR HOLDING THE VALUE OF 
THE KEY PRESSED FOR THE NUMERICAL KEYS, AND THE CARRY BIT SET AND 
THE VALUES 0-7 IN THE ACCUMULATOR FOR THE CONTROL KEYS. IF 
MEMORY LOCATION 0E, WHICH IS DEDICATED TO THE MONITOR AND SHOULD 
NOT NORMALLY BE USED IN PROGRAMS, HAS THE MOST SIGNIFICANT BIT 
CLEAR THEN JSR DISPLAY Wl LL SCAN ONLY ONCE, I F IT IS SET IT Wl LL WAIT 
FOR A KEY TO BE DEPRESSED BEFORE RETURNING TO THE PROGRAM. IT IS 
A GOOD IDEA TO LOAD IT WITH 'IF' IF YOU WISH TO USE THIS FACILITY AS 
OTHER VALUES MAY CAUSE YOU DIFFERENT PROBLEMS. AGAIN SEE THE 
REST OF THIS MANUAL IF YOU REALLY WISH TO UNDERSTAND THE PROCESS. 



a>DDR 


HEX 


LABEL 


INSTRUCTION 


COMMENTS 




CODE 








027C 


69 


00 




ADC ff00 




027 E 


46 


2A 




LSR ANAL + 2 




0280 


69 


00 




ADC #00 




0282 


46 


28 




LSR ANAL + 3 




0284 


69 


00 




ADC #00 




0286 


4A 






LSRA 




0287 


B0 


BF 




BCS ONEOFF 


- NOT A GOOD MOVE 


0289 


C6 


IF 




DEC COUNT 




028B 


D0 


E8 




BNE CONT 


- KEEP CHECKING THE MOVE 


028D 


A2 


03 




LDX #03 


- GOOD MOVE, TRANSFER TO 
ACTUAL STACKS 


028 F 


B5 


24 


BAT 


LDA2X POSS 




0291 


95 


20 




STA2X STACK 




0293 


CA 






DEX 




0294 


10 


F9 




BPL BAT 




0296 


4C 


00 


02 


JMP HUMMOV 


- OPPONENT. 


0299 


A9 


00 


DSPGAP 


LDA #00 




029B 


A2 


07 




LDX #07 




029D 


95 


10 


CLEAR 


STAZX D 


- CLEAR THE DISPLAY FIRST 


029 F 


CA 






DEX 




02A0 


10 


FB 




BPL CLEAR 




02A2 


D8 






CLD 


- CLEAR DECIMAL MODE 


02A3 


A2 


04 




LDX #04 


- DISPLAY STACKS 


02A5 


A0 


ftlc 


;? 


LDY#01 o? 




02AY 


B5 


IF 


AROUND 


LDAZX STACK ■ 


-1 


02A9 


20 


7A 


FE 


JSR HEXTD 




02AC 


e& 


U 




WYJeV 




02AD 


Q& 


««. 




\m vey 




02AE 


CA 






DEX 




02AF 


D0 


F6 




BNE AROUND 




02B1 


60 






RTS 


■^ iC 


02B2 








^ - 


,' *- ir 



THE DUCKSHOOT GAME IS A SPEED TEST: YOU HAVE TO SHOOT THE FLYING 
DUCKS. THEY SUCCESSIVELY ENTER FROM THE RIGHT AND FLY TOWARDS 
THE LEFT AT A SET SPEED. YOU SHOOT A DUCK BY PRESSING ITS CURRENT 
POSITION ON THE KEYBOARD. THE LEFT MOST DISPLAY IS 0,THE RIGHTMOST 
DISPLAY IS 7. WHEN A DUCK IS HIT IT DIES. THE GAME MAY BE RESTARTED 
WITH ANY HEX DIGIT KEY 



DUCK SHOOT 








ADDR HEX 


LABEL 


INSTRUCTION 


COMMENTS 


CODE 








0200 A9 IF 


BEGIN 


LDA#1F 


- SINGLE SCAN DISPLAY ROUTINE 


0202 85 0E 




STA Z 0E 




0204 A9 00 




LDA #00 


- CLEAR THE DISPLAY 


0206 A2 07 




LDX #07 




0208 86 20 




STX Z 20 




020A 95 10 


CLEAR 


STAZX 10 




020C CA 




DEX 




020D 10 FB 




BPL CLEAR 




020F A9 00 


REMOVE 


LDA #00 


- TAKE THE OLD DUCK OFF 


0211 A6 20 




LDX H 20 





MAIN PROGRAM 



JSR ALBERT 1- ALBERT PROGRAM 



JSR ALGERNON 



ALGERNON PROGRAM 



RTS 



RTS 



WE CANT JUST SAY THAT PC IS TO BE SAVED IN LOCATION, SAY, L& M-WE 
WOULDN'T GET BACK FROM ALBERT SINCE THE CALL TO ALGERNON WOULD 
HAVE DESTROYED THE NECESSARY INFORMATION IN L & M. (IT IS WORTH 
NOTING HERE THAT L&M COULD BE "CALLED" -2 "CALLED" -1. THEN A 
CALL TO ALBERT AS A SUBROUTINE WOULD STORE THE RETURN ADDRESS 
JUST BEFORE THE START OF ALBERT ALLOWING NESTED SUBROUTINES AS 
ABOVE. A PROBLEM IS THAT THIS DOES NOT WORK WITH READ ONLY 
MEMORY, LIKE THE MONITOR). 
3.2 THE STACK POINTER 

WE NEED SOMETHING WHICH WILL DECIDE WHAT L & MARE TO BE, 
DEPENDING ON WHICH SUBROUTINE WE ARE IN. AN OBVIOUS CHOICE IS TO 
USE AN ARRAY OF MEMORY LOCATIONS, AND A VARIABLE WHICH POINTS TO 
THE CURRENT LOCATION OF L & M, EACH TIME WE DO A JSR WE STEP UP THE 
POINTER & EACH TIME WE DO AN RTS WE STEP IT DOWN. 



RETURN ADDRESS ARRAY 
IPOINTERI - 



WITH ACORN WE'LL NEED TWO BYTES FOR EACH RETURN ADDRESS. THIS IS 
NO TROUBLE, WE JUST INCREMENT & DECREMENT THE POINTER TWICE. THE 
WHOLE PROCESS IS CARRI ED OUT BY THE PROCESSOR AUTOMATICALLY ON 
EACH JSR & RTS, THE POINTER IS CALLED THE STACK POINTER AND IS A 
SPECIAL 8 BIT REGISTER INSIDE THE PROCESSOR. THE ARRAY IS USUALLY 
CALLED A STACK SINCE IT CAN ALSO BE USED TO STORE THINGS OTHER 
THAN RETURN ADDRESSES. THE ACTUAL STACK RUNS FROM 01 FF DOWN TO 
01100, AND IT STARTS AT THE TOP: AN EMPTY STACK HAS STACK POINTER 
AT FF. A BYTE IS PUT ON THE STACK AND THE POINTER IS DECREMENTED TO 
POINT AT THE NEXT LOCATION; THE POINTER IS INCREMENTED AND A BYTE 
LOADED FROM THE STACK IN THE REVERSE OPERATION. NO CHECK IS MADE 
FOR THE 00 TO FF DECREMENT INDICATING AN OVERFLOWED STACK, SO 
PROGRAMS THAT REQUIRE MORE THAN 256 BYTES OF STACK SPACE Wl LL 
MYSTERIOUSLY FAIL. SINCE THIS IS 128 CONSECUTIVE JSR'S, THE PROBLEM 
WON'T BE ENCOUNTERED VERY OFTEN. . . 
NOW THE PROCESSOR STATUS REGISTER CAN BE PUSHED ONTO THE STACK: 



PLP 28 "PULLP" 

PHP 08 "PUSH P" 

AND SO WE MAY SAVE IT BEFORE A SUBROUTINE CALL AND RECOVER IT 
AFTERWARDS 

PHP 

JSR . . . . 

PLP 
THE SEQUENCE OF STACK OPERATIONS IS 







1 s h- 

IPC 1 


TOP 








TOP 






P 






1 s h 

i P 1 






TOP 


PCH 


TOP 


1 s h 


1 s N 




PCL 


1 s h^ 


P 


TOP 






/^ 






PCH 


P 


/^ 


PCL 


PCH 




PCL 


1 ^ 1 


1 PC 1 


1 PC 1 





PHP 



JSR PROGRAM OPERATES RTS 



PLP 



SO WE HAVE NOW MANAGED TO SAVE THE CARRY FLAG, USE FE60, AND 
REGAIN THE CARRY FLAG. WE WISH TO WRITE IT OUT, SO IT WOULD HAVE 
BEEN BETTER TO WRITE. 

PHP 

JSR FE60 

PLA PULL BYTE FROM STACK INTO A 

SINCE THIS GIVES THE CARRY FLAG IN A, AS THE LEAST SIGNIFICANT BIT, 
TO GET RID OF THE REST OF THE BITS OF THE RECOVERED STATUS 
REGISTER,WE CAN SIMPLY AND # 01. NOW A CONTAINS OR 1 DEPENDING 
ON THE CARRY FROM ORIGINAL SUM. OUR PROGRAM NOW IS 

SED SET UP FOR DECIMAL ADD 

CLC 

LDAZ21 DOIT 

ADC Z 20 

PHP SAVE CARRY 

JSR FE60 WRITE OUT TWO DIGITS 

ON DISPLAYS6&7 



-»S 



PLA 
AND#01 



A = (NO CARRY FROM SUM) 

OR A = 1 (CARRY FROM SUM) 



NOW ALLWE NEED TO DO IS WRITE OUT THE ACCUMULATOR ON DISPLAY 
N0.5. THE WAY WE WROTE OUT THE FIRST TWO DIGITS OF THE RESULT WAS 
TO USE A MONITOR SUBROUTINE WHICH DID JUST THAT. YOU'VE PROBABLY 
NOTICED THAT THE MONITOR ONLY PUTS A DOT ON DISPLAY 5 (THE 3RD 



ADDR 


HEX 


LABEL 


INSTRUCTION 


COMMENTS 




CODE 








0210 


29 


7F 




AND#7F 




0212 


95 


11 




STA2X D + 1 




0214 


E8 






INX 


- MOVE FORWARD 


0215 


E8 






INX 




0216 


E0 


07 




CPX #07 


- END OF STACKS? 


0218 


90 


E9 




BCCSHIFTPT 




021A 


A2 


00 




LDX #00 




021 C 


F0 


E5 




BEQSHIFTPT 




021 E 


A8 




MINUS 


TAY 




021 F 


F0 


E8 




BEQ CHEAT 


- PREVENT ZERO FROM BEING USE 


0221 


8A 






TXA 




0222 


4A 






LSRA 


- ADDRESS OF REQUIRED STACK 


0223 


AA 






TAX 




0224 


38 






SEC 




0225 


85 


20 




LDAZX STACK 


- DO THE PLAYER'S MOVE 


0227 


E5 


0D 




SBC KEY 




0229 


95 


20 




STA2X STACK 




022 B 


20 


99 


02 COMMOV 


JSR DSPGAP 


- SHOW STACKS 


022 E 


84 


0E 




STY REPEAT 




0230 


A2 


00 




LDX #00 




0232 


20 


0C 


FE WAIT 


JSR DISPLAY 


- THINKING TIME 


0235 


CA 






DEX 




0236 


D0 


FA 




BNEWAIT 




0238 


CA 






DEX 




0239 


86 


0E 




STX REPEAT 


- CLEAR REPEAT STATUS 


023B 


A0 


03 




LDY#03 




023D 


A2 


03 


NEXTS 


LDX #03 


- TRANSFER STACK TO POSS 


023F 


B5 


20 


BLOCK 


LDAHX STACK 


- POSS REPRESENTS THE POSSIBLE 
COMPUTER 


0241 


95 


24 




STA2X POSS 


- MOVES 


0243 


CA 






DEX 




0244 


10 


F9 




BPL BLOCK 




0246 


A2 


03 


ONEOFF 


LDX #03 


- TRANSFER POSS TO ANAL 


0248 


B5 


24 


BRICK 


LDA2X POSS 


- ANAL REPRESENTS THE MOVE 
BEING 


024A 


95 


28 




STA2X ANAL 


- ANALYSED 


024C 


CA 






DEX 




024D 


10 


F9 




BPLBRICK 




024F 


A2 


03 




LDX #03 




0251 


89 


24 


00 


LDA, Y POSS 




0254 


38 




ol 


SEC 




0255 


E9 


00 


SBC #01 




0257 


99 


24 


00 


STA, Y POSS 


- POSS CONTAINS POSSIBLE MOVE 


025A 


99 


28 


00 


STA, Y ANAL 


- ANAL CONTAINS POSSIBLE MOVE 


025D 


80 


12 




BCS CHECK 




025F 


88 






DEY 




0260 


10 


DB 




BPL NEXTS 


- TRY ALL STACKS 


0262 


85 


20 


TRY 


LDAZX STACK 


- CHECK IF STACK EMPTY 


0264 


F0 


05 




BEQ EMPTY 




0266 


D6 


20 




DECEX STACK 


- MAKE DESPERATE MOVE 


0268 


4C 


00 


02 


JMPHUMMOV 




026B 


CA 




EMPTY 


DEX 




026C 


10 


F4 




BPLTRY 




026E 


4C 


04 


FF 


JMP RESTART 


- LOST. 


0271 


A9 


04 


CHECK 


LDA #04 




0273 


85 


IF 




STA COUNT 




0275 


A9 


00 


CONT 


LDA #00 


- EVALUATE MOVE 


0277 


46 


28 




LSR ANAL 




0279 


2A 






ROLA 




027A 


46 


29 




LSR ANAL + 1 





ADDR 


HEX LABEL 
CODE 


INSTRUCTION 


COMMENTS 


0207 


E0 07 


CPX #07 




0209 


D0 F7 


BNE LOOP 


- KEEP GOING 


020B 


85 17 


STA Z D + 7 


- NEW DATA 


020D 


60 


RTS. 




020E 








GAMES PROGRAMS 
1 







NIMISATRADITIONALGAME INWHICH THE PLAYERS ALTERNATIVELY REMOVE 
STICKS, OR COINS, OR WHATEVER FROM ONE OF SEVERAL STACKS. THE 
ONLY RULES ARE THAT YOU MUST TAKE AT LEAST ONE PIECE PER MOVE 
AND THAT YOU CAN ONLY REMOVE PIECES FROM ONE STACK PER MOVE. 
THERE IS A WELL-DEFINED STRATEGY FOR OPTIMAL PLAY BUT THIS DOES 
NOT GUARANTEE A WIN UNLESS THE OPPONENT MAKES A MISTAKE OR THE 
INITIAL SITUATION IS AGAINST HIM. THE COMPUTER PLAYS WELL BUT, WITH 
LUCK, CAN BE BEATEN. THE WINNER IS THE PLAYER WHO REMOVES THE 
LAST PIECE 

IN THIS VERSION OF THE GAME THERE ARE FOUR STACKS OF FROM 0-F 
PIECES. YOU MUST ENTER THE SIZE OF YOUR STACKS IN MEMORY . -,o 

LOCATIONS 20-23 BEFORE STARTING THE GAME. THE GAME STARTS AT 002f 
AND YOUR MOVE OR 0180 AND THE COMPUTER'S MOVE. ON RUNNING, THE 
DISPLAY WILL SHOW A- B C D WHERE A,B,C,D ARE THE CONTENTS OF 
THE STACKS. ANY CONTROL KEY Wl LL MOVE THE POINTER (FULL STOP) 
AROUND THE STACKS. WHEN IT POINTS TO THE STACK FROM WHICH YOU 
WISH TO REMOVE PIECES PRESS THE KEY CORRESPONDING TO THE NUMBER 
YOU WISH TO REMOVE. ZERO IS I LLEGAL AND WILL NOT BE ALLOWED. IF 
YOU SUBTRACT MORE PIECES THAN ARE IN THE STACK THE GAME WILL GET 
VERY CONFUSED. 

AFTER REMOVALOFPIECESTHEDISPLAYWILLSHOWTHE CURRENT 
SITUATION AND THE COMPUTER WILL MAKE ITS MOVE. 
CONTINUE UNTIL SOMEONE (SOMETHING?) WINS. 

YOU MIGHT LIKE TO TRY AND WRITE SUBROUTINES TO PRINT MESSAGES 
ON THE DISPLAY IN THE EVENT OF EITHER A HUMAN OR COMPUTER 
VICTORY. A CHECK WOULD HAVE TO BE INSERTED TO DECIDE A 
COMPUTER WIN BUT THE JUMP FOR A HUMAN WIN IS ALREADY THERE 
UNDER THE MNEMONIC JMP MESSAGE, THOUGH THE CODE IN FACT JUMPS 
TO THE HUMAN MOVE. 



NIM 



(J200 


20 


99 


02 HUMMOV 


JSR DSPGAP 


0203 


85 


11 


SHIFTPT 


LDHX D + 1 


0205 


09 


80 




ORA#80 


0207 


95 


11 




STAZX D + 1 


0209 


20 


0C 


FE CHEAT 


JSR DISPLAY 


020C 


90 


10 




BCC MINUS 


020E 


85 


11 




LDAZX D + 1 



NOT RELOCATABLE 
CLEAR DECIMAL 
DISPLAY STACKS 
SET DECIMAL POINT ON 



WAIT FOR INPUT 

REMOVE CURRENT DECIMAL POINT 



FROM THE RIGHT) AND SUSPECT THAT IT CAN'T PUT ANYTHING ELSE THERE. 
THIS IS TRUE, BUT IT DOESN'T MEAN THAT THERE ISN'T A MONITOR SUB- 
ROUTINE THAT CAN DO THE JOB. SUCH A SUBROUTINE LIVES AT FE7A. IT IS 
DESIGNED TO PUT THE LOWEST FOUR BITS OF THE ACCUMULATOR ONTO 
ANY OF THE DISPLAYS, AS A READABLE CHARACTER. THIS IS JUST WHAT WE 
NEED- BUT HOW DO WE TELL THE SUBROUTINE WHICH DISPLAY TO USE? 

3.3 THE INTERNAL REGISTERS X ANDY. 

WELL, BACK TO THE /nP. THIS ISWHAT IT LOOKS LIKE INSIDE 



7 



A 



15 



BIT NUMBER 
ACCUMULATOR 

X-REGISTER 
Y-REGISTER 



}l 



NDEX 
EGISTERS 



PC 



PROGRAM COUNTER 
STACK POINTER 
PROCESSOR STATUS 



TWO NEWCOMERS, YOU'LL NOTICE! X & Y ARE 'INDEX REGISTERS', THEY WILL 
BE DEALTWITH MORE THOROUGHLY IN A FEW MORE PAGES, BUT WHAT 
MATTERS NOW IS THE USE FE7A MAKES OF THEM: 

I FE7A NEITHER CARES ABOUT, NOR CHANGES X 

II FE7A DOESN'T CHANGE Y, BUT THE DISPLAY IT PUTS A ONTO IS 
CONTROLLED BY Y THAT IS, THE LOWER 4 BITS OF A ARE TRANSFORMED 
INTO THE CORRECT SEQUENCE OF BITS TO REPRESENT THEIR HEXADECIMAL 
CHARACTER AS IT SHOULD APPEAR ON THE 7 SEGMENT DISPLAY. THEN THIS 
IS STORED IN MEMORY TO AWAIT THE SUBROUTINE WHICH ACTUALLY PUTS 
THINGS ON DISPLAY. 

ALTHOUGH FE7A MAKES NO RESTRICTIONS ON THE SIZE OF Y, THE MONITOR 
SUBROUTINE WHICH DISPLAYS THEM ONLY KNOWS ABOUT THE FIRSTS 
(NUMBERED. OF COURSE, 0-7) OF THEM, IN LINE WITH THE ACTUAL DISPLAY 
HARDWARE. DISPLAY IS THE LEFTMOST, DISPLAY 7 IS THE RIGHTMOST. 
TO KEEPTHE MONITOR AS EFFICIENT AS POSSIBLE THE SUBROUTINE AT 
FE60 USES FE7A. IT FOLLOWS THAT IT MUST HAVE LOADED Y WITH 7 & 6, 
AND SINCE FE7A DOESN'T CHANGE Y, Y IS STILL SET TO THE LAST USED OF 
THESE WHICH IS 6. SO. INSTEAD OF USING 

LDY#05 A0 05 "LOAD Y WITH THE NEXT BYTE" (05 HERE) 

WE CAN USE 

DEY 88 "DECREMENT (IN HEXADECIMAL) Y BY 

ONE" 



ii 



TO SET Y TO 5, THUS SAVING A WHOLE BYTE! (BUT NO TIME, THE TWO 
INSTRUCTIONS ARE EXECUTED IN THE SAME TIME, 2^5). THE COMPLETE 
PROGRAM IS 

SED 

CLC 

LDAZ21 

ADC Z 20 

PHP 

JSR FE60 

PLA 

AND #01 

DEY 

JSR FE7A 

JMP FF04 
,WE FIND THE ANSWER TO501 0+5010 IS 



FE 



002 F F8 

0030 18 

0031 A5 21 
0033 65 20 
0035 08 
0086 20 60 

0039 68 
003A29 01 
003C 88 
003D20 7AFE 

0040 4C04FF 
AND SO, AT LAST, 



K. 



002F 



100 



PERHAPS WE SHOULD HAVE CLEARED THE DISPLAY? OR MADE IT SHOW THE 
NUMBERS TO BE ADDED TOGETHER? OR ACTUALLY FETCHED THE TWO 
NUMBERS USING KEYBOARD AND DISPLAY LIKE THE MONITOR DOES? OR 
SOME COMBINATION OF THESE? 

3.4 MAKING OUR PROGRAM 'FRIENDLY' 

USING THE MONITOR SUBROUTINE AT FE88 IT IS EASY TO DO THE THIRD 
OPTION. FE88 IS THE ROUTINE WHICH FETCHES 4 DIGIT NUMBERS, 
TERMINATED BY ANY COMMAND KEY, INTO THE TWO BYTES IN ZERO PAGE 
X&X+ 1 [i.e. IF X CONTAINS 20, INTO 0020 (LOW BYTE = RH PAIR OF 
NUMBERS) & 0021] JUST WHAT WE NEED! 

SED 

LDX# 20 

JSR FE88 

CLC 

LDA Z 21 

ADC Z 20 

PHP 

JSR FE60 

PLA 

AND #01 

DEY 

JSR FE7A 

JMP FF04 

ONCE AGAIN THE PROGRAM HAS BEEN EXTENDED BACKWARDS SINCE THE 
GREATER PART OF IT HAS ALREADY BEEN ENTERED (UNLESS YOU'VE 
SWITCHED OFF AND LOST IT ALL) 
RUNNING THIS PROGRAME (G0,0,2,A, k ) PRODUCES 



002A 


F8 


002B 


A2 20 


002D 


20 88FE 


0030 


18 


0031 


A5 21 


0033 


65 20 


0035 


08 


0036 


2060 FE 


0039 


68 


003A 


29 01 


003C 


88 


003D 


20 7AFE 


0040 


4C04FF 



K. 5 05 • (ON THE ASSUMPTION THAT 0020 &0021 STILL 

CONTAIN THE 50-3 ADDED TOGETHER AS BEFORE) 



THE FIRST PROGRAM, TEST, IS TRIVIAL: IT JUST SENDS A PARTICULAR BYTE 
TO TAPE REPETETIVELY. IT MUST BE STOPPED BY RESET. RECORD A FEW 
MINUTES OF THIS, THEN LOAD IT USING LOAD. DEVIATIONS FROM THE 
STATIONARY PATTERN ARE EASY TO SEE. THE SECOND PROGRAM, RETAG, 
IS RELOCATABLE. IT ACTS JUST LIKE THE MONITOR'S STORE ROUTINE, 
EXCEPT THAT IT ASKS FOR AN EXTRA ADDRESS. THE DATA WHICH IS 
STORED IS THAT STARTING AT THIS LAST ADDRESS, IT PRETENDS TO BE 
SITUATED BETWEEN THE FIRST TWO ADDRESSES. INCORPORATE THE 
REQUIREDSTATE OF ZERO PAGE REGISTERS IN FRONT OF YOUR DATA, 
THEN 'LOAD AND AUTO RUN' PROGRAMS MAY BE CREATED. 



TAPE PROGRAMS 



NOT RELOCATABLE 



ADDR HEX LABEL 
CODE 

0200 A9 55 TEST 

0202 20 B1 FE 

0205 4C 00 02 

0208 A9 F1 RETAG 

020A 85 10 

020C A2 06 

020E 20 88 FE 

0211 A2 08 

0213 86 10 

0215 20 88 FE 

0218 A9 46 

021A 85 10 

021 C A2 20 

021 E 20 88 FE 

0221 A2 04 

0223 85 05 ADRSS 

0225 20 B1 FE 

0228 CA 

0229 D0 F8 

022B A0 00 DATAS 

022D 81 20 

022F E6 20 

0231 D0 02 

0233 E6 21 

0235 20 81 FE N0I1NC 

0238 20 A0 FE 

0238 D0 EE 

023D 4C 04 FF 

0240 



INSTRUCTION 

LDA #55 
JSR PUTBYTE 
JMP TEST 
LDA #F1 
STAD 
LDX #06 
JSR GDATFET 
LDX #08 
STX D 

JSR QDATFET 
LDA #46 
STAD 
LDX #20 
JSR QDATFE7 

LDX #04 
LDA Z,X 05 
JSR PUTBYTE 
DEX 

BNE ADDRSS 
LDY #00 
LDA(20),Y 
INC 20 

BNENOINC 
INC 21 

JSR PUTBYTE 
JSR C0M16 
BNE DATAS 
JMP RESTART 



COMMENTS 

- THE TEST BYTE 

- SEND IT 

- KEEP SENDING IT 

- F. PROMPT 



FIRST ADDRESS 

PROMPT 

SECOND ADDRESS 
PROMPT 



LAST ADDRESS: ACTUAL DATA 
START 

SEND FAKE ADDRESSES 



PROPER DATA 
INCREMENT PROPER DATA 
COUNTER 



SEND DATA 

CHECK FAKE ADDRESSES FOR END 



THE SCROLL PROGRAM SHIFTS THE WHOLE DISPLAY ONE LEFT, AND 
ENTERS THE NEW INFORMATION, IN A, ON THE FAR RIGHT. 
SCROLL 



ADDR 


HEX 


LABEL 


INSTRUCTION 


COMMENTS 




CODE 








0200 


A2 00 




LDX #00 


- MUST GO FORWARDS 


0202 


84 11 


LOOP 


LDY ZX D + 1 


- PICK-UP DATA ON RIGHT 


0204 


94 10 




STY 2X D 


- & MOVE IT ONE LEFT 


0206 


E8 




INX 





025A 
0250 
025F 



00 71 77 
50 00 



THE RELOCATOR FIRST FETCHES THE THREE ADDRESSES IT REQUIRES, THE 
ADDRESSES OF THE START & END OF THE MEMORY SECTION TO BE MOVED, 
AND THE ADDRESS OF THE START OF THE AREA TO WHICH THE MOVE IS TO 
TAKE PLACE. THE PROMPTS ARE F., & t RESPECTIVELY. AFTER 
TERMINATING THE LAST ADDRESS, THE MOVE TAKES PLACE. MOVES UP BY 
LESS THAN THE LENGTH OF THE MATER I AL TO BE USED Wl LL NOT BE 
SUCCESSFUL (I.E. t - F ., IF POSITIVE, SHOULD BE GREATER THAN -t ) 



RELOCATOR 



ADDR 

0200 
0202 
0204 
0206 
0209 
020B 
020D 
020 F 



HEX 
CODE 
A2 F1 
86 10 
A2 20 
20 88 FE 
A2 46 
86 10 
A2 22 
20 88 FE 



0212 A2 78 

0214 86 10 

0216 A2 24 

0218 20 88 FE 



LABEL INSTRUCTION 

LDX #F1 
STXH D 
LDX #20 
JSR QDATFET 
LDX #46 
STXZ D 
LDX #22 
JSR QDATFET 



LDX #78 
STXZ D 
LDX #24 
JSR QDATFET 



021 B A2 1A 

021 D A1 06 MOVE 

021 F 91 24 

0221 C8 

0222 D0 02 
0224 E6 25 

0226 20 A0 FE NOINC 

0229 D0 F2 

022B 4C 04 FF 
022D 



LDX#1A 
LDA (06,X) 
STA (24,Y) 
INY 

BNE NOINC 
INC 2 25 
JSR COM 16 
BNE MOVE 
JMP RESTART 



COMMENTS 

- SET UP FROM PROMPT F. 

- AND GET ADDRESS 

- SET UP END PROMPT 

- AND GET SECOND ADDRESS - 
MOVE THE DATA BETWEEN THESE 
ADDRESSES 

- SET UP TO PROMPT 

- AND GET BASE ADDRESS - MOVE 
TO HERE & SUCCESSIVE 
LOCATIONS 

- DO THE MOVE 

- INCREMENTTHE TO ADDRESS 

- USEC0M16T0 DOTHE LIMITTEST 



YOU SHOULD ENTER THE TWO PAIRS OF NUMBERS YOU WISH ADDED 
TOGETHER AS IF THEY FORMED AN ADDRESS. TERMINATING YOUR ENTRY 
WITH k INSTANTLY PRODUCES THE RESULT 



K. 



5050 



100 



LOOKING BACK OVER THE PROGRAM, AND EXAMINING THE MONITOR 
LISTING, WILLREVEALTHAT ITTOOK ADjs (OR 173io) BYTES OF CODE TO 
ACHI EVE THIS. THE ACTUAL OPERATION USED 6 BYTES OF CODE (SED; CLC; 
LDAZ; ADC Z) WHILE THE OTHER 167io ARE THERE 'MERELY' TO DISPLAY 
THE RESULT& FETCH THE INFORMATION NEATLY(THE CODE CALCULATIONS 
DO NOT CONSIDER THE 16io BYTES OF CHARACTER FONT OR THE 11 lo 
BYTES OF TEMPORARY STORAGE ALSO USED) 

CHAPTER 4: THE REMAINDER OF THE INSTRUCTION SET 
4.1 BRANCHES 

THINKING ABOUT THE FE88 PROGRAM, YOU SHOULD REALIZE THAT IT DOES 
SOMETHING OF THE FORM 

FETCH NEXT KEY 

if KEY IS A COMMAND KEY THEN RETURN 
THIS IS A CONDITIONAL TRANSFER OF CONTROL AND REPRESENTS SOME 
NEW INSTRUCTIONS AND A DIFFERENT WAY OF CHANGING THE PROGRAM 
COUNTER. AN OPERATION LIKE ADC DOES MORE THAN ADDING TWO BYTES 
AND THE CARRY FLAG TOGETHER AND OUTPUTTING A CARRY. IT ALSO SET! 
SOME OF THE OTHER FLAGS IN P: 

THE EFLAG IS SET IF THE RESULTING BYTE WAS ZERO 
THE V FLAG IS SET IFTHERE WAS A 2'S COMPLEMENT OVERFLOW 
THE N FLAG IS SET IF THE RESULT WAS A NEGATIVE 2'S COMPLEMENT 
NUMBER - I.E. BECOMES BIT 7 OF THE RESULT. 
THESE FLAGS ARE ABLE TO CAUSE CONDITIONAL TRANSFER BY USING 
THE APPROPRIATE ONE OF THE EIGHT 'BRANCH' INSTRUCTIONS. THE 
MECHANISM EMPLOYED IS TO PERFORM A 2'S COMPLEMENT ADD BETWEEN 
THE PROGRAM COUNTER AND THE SECOND BYTE OF THE BRANCH 
INSTRUCTION THUS PERMITTING THE TRANSFER TO BE -128. . . +127 BYTES 
FROM THE NEXT INSTRUCTION. THIS IS CALLED 'RELATIVE ADDRESSING' 
AND IS A POSITION INDEPENDENT METHOD OF TRANSFER, THE EIGHT 
BRANCH INSTRUCTIONS ARE ASSOCIATED TWO TO EACH OF THE C, Z, V & 
N FLAGS, ONE OF WHICH BRANCHES IF THE FLAG IS SET, THE OTHER 
BRANCHES IF IT IS CLEAR. 



TO CLARI FY THIS LET'S LOOK AT AN EXAMPLE: 



L» > > 



BCS03 
SEC 
^CS01 
CLC 



"BRANCH IF CARRY SET" 
SET CARRY 

CLEAR CARRY 



* + (3 

* + 2 

* + 3 

* + 5 

* + 6 
(THE ARROWS ARE PUT IN FOR CLARITY) 

WE'LL NEED TO CONSIDER THIS PROGRAM BOTH WITH THE CARRY SET & 
WITH IT CLEAR 
I CARRY IS CLEAR 



+ 


BCS 


+ 2 


, SEC 


+ 3 


BCS 


+ 5 


^ CLC 


+ 6 





03 'T 



FB 



INSTRUCTION I DOES NOT TRANSFER CONTROL SO WE DO INSTRUCTION II, 
SEC, NOW INSTRUCTION III TRANSFERS CONTROL SINCE THE CARRY IS NOW 
SET. 01 IS ADDED TO THE PC (= » + 5) TO GIVE* + 6 AS THE ADDRESS OF THE 
NEXT INSTRUCTION. 
II CARRY IS SET 

INSTRUCTION I TRANSFERS CONTROL. 03 IS ADDED TO THE PC (= * + 2) TO 
GIVE * + 5 AS THE ADDRESS OF THE NEXT INSTRUCTION, INSTRUCTION IV. 
CLC. 
SO IF THE CARRY WAS CLEAR IT IS SET; IF IT WAS SET IT IS CLEARED, SO THE 
PROGRAM COMPLEMENTS THE CARRY (THERE ARE QUICKER METHODS, 
INDEED IT CAN BE DONE WITH 3 INSTRUCTIONS IN 4 BYTES)- 

AND WE CAN GO BACKWARDS: 

BRANCH IF CARRY SET 
SET CARRY 

BRANCH IF CARRY SET 
CLEAR CARRY 

IF THE CARRY IS SET THE PROGRAM IS AS BEFORE IF IT IS CLEARED WE SET IT 
& BRANCH FB 

/ 2's COMPLEMENT ADD * + 5 \ 

-EB + 

\ *+0 / 

-BACK TO THE BEGINNING. A RATHER COMPLICATED WAY OF CLEARING 
THE CARRY. 

MOST OF THE NON-BRANCH INSTRUCTIONS WILL CHANGE SOME OF THESE 4 
TESTABLE FLAGS, USUALLY THE N & 2 FLAGS SINCE THEY CONSTANTLY 
MONITOR THE STATUS OF OPERANDS SO BRANCHES Wl LL APPEAR RATHER 
FREQUENTLY IN PROGRAMS. 

4.2 INDEXING 

IF YOU WISHED TO CLEAR (SET EACH BYTE TO 0) A PATCH OF MEMORY, e.g. 
THE MEMORY USED TO STORE THE DATA WHICH IS TO BE OUTPUT TO THE 
DISPLAYS, WHICH IS FROM 0010 TO 0017, YOU MIGHT THINK 

LDA# 00 LOAD ACCUMULATOR IMMEDIATE WITH 00 
STAZ10 STORE ACCUMULATOR IN ADDRESS 0010 
STAf 11 STORE ACCUMULATOR IN ADDRESS 0011 

STA Z 12 STORE ACCUMULATOR IN ADDRESS 0012 



STA Z 17 STORE ACCUMULATOR IN ADDRESS 0017 
IS NECESSARY. THIS LOOKS SUFFICIENTLY REGULAR THAT THE COMPUTER 
SHOULD BE ABLE TO DOT IT. THIS IS WHERE THE INDEX REGISTERS 
REAPPEAR. WE CAN STORE THE ACCUMULATOR INDEXED BY EITHER INDEX 
REGISTER 

STAZ.X 95 "STORE A INDEXED BY X IN ZERO 

PAGE" 

STAZ,X 10 



THE OFFSET CALCULATOR CALCULATES THE OFFSET TO BE ENTERED AS 
THE SECOND BYTE OF A BRANCH INSTRUCTION. IT WILL PROMPT WITH 
XX0000XX AND YOU SHOULD ENTER THE ADDRESS OF THE BRANCH 
INSTRUCTION. AFTER A CONTROL KEY IT WILL PROMPT AGAIN WITH 
XX1 1 1 1XX AND YOU SHOULD ENTER THE ADDRESS YOU WISH TO BRANCH 
TO. THE REPLY Wl LL BE EITHER "OFFSET XX" WHERE XX IS THE VALUE TO 
BE ENTERED, OR "TOO FAR" IF THAT IS THE CASE. A CONTROL KEY 
RESTARTS THE SEQUENCE. 



OFFSET CALCULATOR 



NOT RELOCATABLE 



ADDR 


HEX 
CODE 


LABEL 


INSTRUCTION 


COMMENTS 


nm 


D8 






OLD 




0201 


A9 


02 


AGAIN 


LDA #02 




02(83 


85 


21 




STAMESSH 


- INITIALIZE MESSAGE POINTER 


0205 


84 


22 




STY FROMH 


- SET UP PROMPT 


0207 


84 


23 




STY FROML 




0209 


A2 


22 




LDX#FROML 




020B 


20 


88 


FE 


JSR QDATFET 


- FETCH FIRST ADDRESS 


020E 


A9 


11 




LDA #11 


- SET UP 2ND PROMPT 


0210 


85 


24 




STA TO L 




0212 


85 


25 




STA TON 




0214 


A2 


24 




LDX #TOL 




0216 


20 


88 


FE 


JSR QDATFET 


- FETCH SECOND ADDRESS 


0219 


A5 


22 




LDA FROML 


- OFFSET TO MAKE OVER LENGTH 
EASY 


021 B 


E9 


7E 




SBC #7E 


- CARRY KNOWN SET BY QDATFET 


021 D 


85 


22 




STA FROML 




021 F 


80 


03 




BCS HSUB 


- DONT SET THE CARRY AGAIN! 


0221 


C6 


23 




DEO FROMH 




0223 


38 






SEC 




0224 


A5 


24 


HSU8 


LDA TO L 


- CALCULATE THE LENGTH 


0226 


E5 


22 




SBC FROML 




0228 


AA 






TAX 




0229 


A5 


25 




LDA TOH 




0228 


E5 


23 




SBC FROMH 




022D 


D0 


0E 




BNE TOOFAR 




022F 


A9 


51 




LDA #51 




0231 


20 


44 


02 


JSR MESSAGE 


- PRINTOUT 


0232 


8A 






TXA 




0235 


49 


80 




EOR #80 


- COMPLEMENT TOP BIT BECAUSE OF 
THE OFFSET APPLIED 


0236 


20 


60 


FE 


JSR RDHEXTD 


- PRINT OUT ANSWER, OVER 
WRITING THE 


0239 


40 


04 


FF 


JMP RESTART 


- FINISHED 


023C 


A9 


57 


TOOFAR 


LDA #57 


- WHOOPS 


023E 


20 


44 


02 


JSR MESSAGE 


- TELL THE PROGRAMMER THAT IT'S 
WRONG 


0241 


40 


01 


02 


JMP AGAIN 


- AND GET IT DONE AGAIN 


0244 


85 


20 


MESSAGE 


STA MESSL 


- MESSAGE DESCRIBED BY A 


0246 


A0 


07 




LDY #07 


- EIGHT BYTES OF DATA TO DISPLAY 


0248 


81 


20 


LOOP 


LDA (MESSL), Y 


- FETCH THEM 


024A 


99 


10 


00 


STA D, Y 




024D 


88 






DEY 




024E 


10 


F8 




BPL LOOP 




0250 


60 






RTS 




0251 


50 


71 


71 




- THE DATA 


0254 


ED 


79 


78 






0257 


78 


50 


50 







THE HEXADECIMAL TO DECIMAL CONVERTER PROMPTS WITH XX0000XX 

AND AFTER A CONTROL KEY IS PRESSED WILL PROVIDE AN ANSWER IN THE 

FORM ????????, AFTER A WAIT! 

THE PROGRAM WORKS BY DECREMENTING THE HEX. NUMBER AND 

INCREMENTING THE DECIMAL NUMBER UNTILTHE HEX. NUMBER REACHES 

ZERO. 

THIS PROGRAM, LIKE THE DECIMAL TO HEX. CONVERTER, WHICH USES 

VIRTUALLY THE SAME METHOD, ILLUSTRATES THE USE OF THE 

DECIMAL MODE, AN IMPORTANT FACET OF THIS PROCESSOR. 

THEY ALSO PROVIDE AN EXCELLENT DEMONSTRATION OF THE TRADEOFF 

FREQUENTLY FOUND BETWEEN PROGRAM LENGTH AND SIMPLICITY, AND 

PROGRAM EXECUTION TIME. THE METHOD USED IS BOTH SHORT AND SIMPLE, 

BUT CAN TAKE UP TO THREE SECONDS FOR SOME CALCULATIONS. A MUCH 

LONGER AND MORE COMPLEX (RELATIVELY) PROGRAM COULD HAVE BEEN 

WRITTEN BASED ON ABCD = A(16*16*16)+B(16*16)+C(16)+D AND WOULD HAVE 

BEEN VIRTUALLY INSTANTANEOUS. 



HEX ^ DEC 



ADDR 

02(90 
0202 
0204 
0206 
0209 
020A 
020C 
020E 
0210 
0212 
0214 
0216 
0218 
021 A 
021 B 
021 C 
021 E 
021 F 
0220 
0222 
0223 
0225 
0227 
0229 
022B 
022D 
022F 
0232 
0233 
0235 
0238 
023A 



HEX 
CODE 

84 20 

84 21 

A2 20 

20 88 
F8 

A2 00 

86 22 

A5 20 

D0 06 

A5 21 

F0 13 

C6 21 

C6 20 
18 
98 

69 01 
A8 
8A 

69 00 
AA 

90 E9 

E6 22 

80 E5 

84 20 

86 21 

A2 20 

20 64 
88 

A5 22 

20 7A 

4C 04 



LABEL 



FE 



DECRHEX 



NODEC 



DEAD 



FE 



FE 
FF 



INSTRUCTION 

STY Z HEX L 

STY Z HEXH 

LDX #HEXL 

JSR Q DATFET 

SED 

LDX #00 

STX 2 DECOUT 

LDAZ HEXL 

BNENODEL 

LDAZ HEXH 

BEQ DEAD 

DEC Z HEXH 

DEC Z HEXL 

CLC 

TYA 

ADC #01 

TAY 

TXA 

ADC #00 

TAX 

BCC DECRHEX 

INC 2 DECOUT 

BCS DECRHEX 

STY Z HEXL 

STX E HEXH 

LDX#HEXL 

JSR QHEXTD1 

DEY 

LDAZ DECOUT 

JSR HEXTD 

JMP RESTART 



COMMENTS 



SET UP ZERO PROMPT 



AND FETCH THE DATA 

DECIMAL MODE 

SET X & Y & DECOUT TO ZERO 

TEST FOR ZERO.THEN DECREMENT 



- IF HEX NO. IS ZERO,THEN FINISHED 



ADD 1 TO THE DECIMAL NUMBER, 
USING X & Y AS TWO BYTE 
ACCUMULATOR 



FINISHED, SO STORE X & Y 



- DISPLAY 4 DIGITS 



- DISPLAY 5 DIGIT 



3\STAE^<10 



X =07, say] 





000F 


\ ■ 


0010 


\ 


0011 
0012 
0013 


\ 


0014 


\ 


\ 


0015 


\ 


0016 


^ — ► 


0017 



A IS STORED IN 17 WHICH IS 10 THE "BASE ADDRESS" +07 THE "INDEX" 

IF WE DO 

A2 07 LDX # 07 

9510 STAZ,X10 

THE STORE IS TO LOCATION 17 (=10 + X). THE ADDITION IS STRAIGHT- 
FORWARD BINARY, TRUNCATED TO A LOCATION IN ZERO PAGE SO 

LDX# FF 

STA2,X 10 
STORES IN LOCATION 0F 
WE ALSO HAVE 

STA,X 9D "STORE A INDEXED BY X" 

STA,Y 99 "STORE A INDEXED BY Y" 

(BUT NO STA Z, Y) WHICH DO NOT NEED TO TRUNCATE THE ADDITION 
THEY EXPECT A TWO BYTE ADDRESS SO 

LDX# FF 

STA, X 0010 
STORES IN LOCATION 010F 
NOW 

DEX CA "DECREMENT (IN HEX) X BY ONE" 

SETS THE Z FLAG IFX IS ZERO, & THEN FLAG EQUAL TO BIT 7 OF X. 

BPL 10 "BRANCH IF PLUS" 

TAKES THE BRANCH IF THEN FLAG IS CLEAR I.E. IS SAYING 'NOT NEGATIVE' 
I.E. PLUS. IT'S EASY TO SE"E THAT THE COMBINATION 



^ 



DEX 
BPL 



FD 



DECREMENTS X ONCE, AND, IF THE RESULT WAS POSITIVE (I.E. IN THE 

RANGE - 7F) IT TAKES THE BRANCH AND DECREMENTS X AGAIN AND 

AGAIN UNTIL IT REACHES A NON-POSITIVE NUMBER, WHICH WILL BE FF, 
WHEN IT DOESN'T TAKE THE BRANCH. IF WE START AT 7 AND EACH TIME 
AROUND THE LOOP CLEAR THE RELEVANT DISPLAY: 

COMMENT 

LOAD ACCUMULATOR IMMEDIATE 
LOADX IMMEDIATE 
STORE^ IN ZERO PAGE INDEXED 
BYX '^ 

DECREMENT X BY ONE 
BRANCH IF PLUS TO "LOOP" 



CODE LABEL 


MNEMONICS 


A9 00 


LDA#00 


A2 07 


LDX #07 


95 10 


LOOP: STA Z,X 10—1 


CA 


DEX 


10 FB 


BPL LOOP - — ' 



so WE CAN WRITE A VERY SHORT PROGRAM TO CLEAR THE DISPLAY. BY 

MAKING THE LOOP SLIGHTLY LARGER (WITH THE SAME LENGTH OF 

PROGRAM) 

0060 A2 07 LDX#07 

0062 B5 48 LOOP: LDA Z, X 48 

0064 95 10 STAZ,X10 

0066 CA DEX 

0067 10 F9 BPLLOOP 
0069 4C04FF JMP FF04 

WE CAN, INSTEAD OF CLEARING THE DISPLAY, CAUSE A BLOCK OF MEMORY, 
0048 - 004F, TO BE TRANSFERRED TO THE DISPLAY. THE PROGRAM IS 
POSITION INDEPENDENT SO YOU CAN WRITE IT INTO MEMORY ANYWHERE. . . 

EXCEPT LOCATIONS 0010 -0017. IF YOU PUT THE PROGRAM IN 0048 IT 

WILL FUNCTION PERFECTLY BUT YOU WON'T BE ABLE TO CHANGE THE DATA 

WHICH IS MOVED, SINCE THIS IS THE PROGRAM. YOU CAN TRY THE PROGRAM 

USING THIS DATA 

0048 00 77 58 5C 50 54 00 00 

OR YOU COULD CONSTRUCT YOUR OWN DATA, USING APPENDIX A. 

THE INDEXING MECHANISM SHOWN ABOVE IS ONLY CAPABLE OF DEALING 

WITH 256 (CONSECUTIVE) BYTES, STARTING AT A GIVEN ADDRESS. THUS 



A9 00 


LDA #00 


LOAD A IMMEDIATE WITH "00" 


A8 


TAY 


TRANSFER A TO Y 


18 


LOOP:CLC 


CLEAR CARRY 


79 00 FE 


ADC, Y FE00 


ADD WITH CARRY INDEXED BY Y 


C8 


INY 


INCREMENT Y 


D0F9 


BNE LOOP 


BRANCH IF NOT EQUAL 


20 60 FE 


JSR FE60 


JUMP SUBROUTINE 


4C 04 FF 


JMP FF04 


JUMP 



COMPUTES THE LOWEST BYTE OF THE 256 BYTE ADDITION. (NOTE THAT, 
SINCE Y IS ZERO WHEN YOU LEAVE THE MONITOR BY THE GO FUNCTION, 
THE INITIALISATION OF A & Y CAN BE ACCOMPLISHED BY TYA INSTEAD OF 
LDA #00, TAY) HOW COULD THIS BE DONE FOR ALL 65536 MEMORY BYTES? 
CLEARLY IT IS POSSIBLE TO HAVE AN ADC, Y FOR EACH PAGE: 
98 TYA 



18 


LOOP 


CLC 




79 0000 




ADC, Y 0000 




18 




CLC 


CLC 


79 00 FF 




ADC, Y 0100 


> 256 ADC, Y INSTRUCTION PAIRS 


18 




CLC 




79 00 FF 




ADC,Y FF00 




C8 




INY 




F0 03 




BEQ END 




4C?? 




JMP LOOP 




20 60 FE END 




JSR FE60 




4C 04 FF 

IN ORDER TO 


SHOR 


JMP FF04 
TEN THIS PROG RA 


M WE WILL INTRODUCE THE CONCEPT 


OF "INDIRECTION". 







ADDR 


HEX 
CODE 


LABEL 


INSTRUCTION 


COMMENTS 


0240 


A2 24 




LDX #24 


- SET UP X 


0242 


20 66 


FE 


JSR QHEXTD2 


- PUT NEXT 4 OUT 


0245 


4C 04 


FF 


JMP RESTART 


- DISPLAY RESULT 


0247 











SYSTEM 

THE DECIMAL TO HEX CONVERTER WILL PROMPT WITH 0XXXX FOR THE 
FIRST DIGIT OF THE 5 DIGIT DECIMAL NUMBER. THEN X0000. FOR THE LAST 
FOUR DIGITS OF THE DECIMAL NUMBER. CLEARLY ANYTHING OVER 65535 
Wl LL GIVE THE REMAINDER WHEN DIVIDED BY 10000 HEX. TO ENTER THIS 
NUMBER YOU WOULD KEY 6, CONTROL KEY, 5535, CONTROL KEY, AND FFFF 
WILL APPEAR ON THE DISPLAY (AFTER A SLIGHT DELAY!) 
THE PROGRAM WORKS BY A PROCESS OF DECREMENTING THE DECIMAL 
NUMBER AND THEN INCREMENTING THE HEX. NUMBER. 



DEC-^ 


■HEX 








0200 


98 






TYA 


0201 


85 


20 




STA 2 DECL 


0203 


85 


21 




STA H DECH 


0205 


A2 


20 




LDX #DECC 


0207 


85 


22 


AGAIN 


STA Z DECVH 


0209 


20 


7A 


FE 


JSR HEXTD 


020C 


20 


0C 


FE 


JSR DISPLAY 


020F 


90 


F6 




BCC AGAIN 


0211 


20 


88 


FE 


JSR QDATFET 


0214 


F8 






SED 


0215 


84 


10 




STYZ D 


0217 


A6 


21 




LDX Z DECH 


0219 


98 






TYA 


021 A 


85 


21 




STA Z DECH 


021 C 


A4 


20 




LDYZDECL 


021 E 


85 


20 




STA H DECL 


0220 


38 




NEXT 


SEC 


0221 


98 




ALSO 


TYA 


0222 


E9 


01 




SBC #01 


0224 


A8 






TAY 


0225 


8A 






TXA 


0226 


E9 


00 




SBC #00 


0228 


AA 






TAX 


0229 


80 


04 




BCS NODEC 


022B 


C6 


22 




DEC Z DECVH 


022D 


30 


09 




BMI RESULT 


022F 


E6 


20 


NODEC 


INC Z DECL 


0231 


00 


ED 




BNE NEXT 


0233 


E6 


21 




INC Z DECH 


0235 


38 






SEC 


0236 


80 


E9 




BCS ALSO 


0238 


A2 


20 


RESULT 


LDX #20 


023A 


20 


64 


FE 


JSR QHEXTD 


0230 


4C 


04 


FF 


JMP RESTART 


023F 











CLEAR A 
CLEAR NO 



- FETCH THE FIRST DIGIT 



AND THEN THE LAST FOUR DIGITS 

DECIMAL MODE 

CLEAR LEFT DISPLAY 

X & Y AS DOUBLE ACCUMULATOR 

CLEAR AREA FOR RESULT 



DO A DECIMAL SUBTRACT, DOUBLE 
BYTE 



LAST OF THE DECIMAL SUBTRACT, 
TO DO 5 DIGITS 
IF MINUS THEN FINISHED 
DOUBLE HEX INCREMENT 



CREATE BRANCH ALWAYS, BUT 
DON'T BOTHER TO SET THE CARRY 
TWICE 



- DISPLAY RESULT 



ADDR 


HE> 




LABEL 


INSTRUCTION 


COMMENTS 




CODE 








0208 


A2 


20 




LDX #20 




020A 


20 


88 


FE 


JSR ODATFET 


- FETCH THE NUMBERS 


020D 


98 






TYA 


- CLEARS A 


020E 


A0 


08 




LDY #08 


- LOOP COUNTER 


0210 


66 


20 


LOOP 


RORS20 


- SHIFT MULIPLIER (AND HIGH BYTE 
OF RESULT) 


0212 


90 


03 




BCCNAD 


- NO ADD IF NO BIT 


0214 


18 






CLC 




0215 


65 


21 




ADC 2 21 


- ADD MULTIPLICAND INTO LOW 
BYTE OF RESULT 


0217 


6A 




NAD 


BORA 


- AND SHIFT LOW BYTE OF RESULT 


0218 


88 






DEY 




0219 


D0 


F5 




BNE LOOP 




0213 


85 


21 




STA2 21 


- PUTIN LOW BYTE 


021 D 


66 


20 




ROR2 20 


- FINAL JUSTIFICATION SHIFT 


021 F 


20 


64 FE 


JSR QHEXTD 


- DISPLAY ANSWER 


0222 


20 


64 FF 


JMP RESTART 




0224 












DOUBl 


.E BYTE MULTIPLY 






ADDR 


HEX 
CODE 


LABEL 


INSTRUCTION 


COMMENTS 


0200 


D8 






CLD 


- BINARY ONLY 


0201 


84 


20 




STY 2 20 MPIER 


- FORM PROMPT FOR THE ZERO 


0203 


84 


21 


1 


STY -2 21 


INPUT 


0205 


A9 


11 


* 


LDA#11 




0207 


85 


22 


1 


STAZ22 MPICAND- FORM PROMPT FOR THE FIRST 


0209 


85 


23 


1 


STA Z 23 


INPUT 


020B 


A2 


20 




LDX #20 




020D 


20 


88 


FE 


JSR ODATFET 


- FETCH ZERO INPUT 


0210 


A2 


22 




LDX #22 




0212 


20 


88 


FE 


JSR ODATFET 


- AND FIRST INPUT 


0215 


84 


24 




STY Z 24 


- CLEAR WORKING SPACE 


0277 


84 


25 




STY 2 25 




0219 


A0 


10 




LDY #10 


- LOOP COUNT INITIALISATION 


021 B 


66 


23 


LOOP 


RORZ23 


- TWO BYTE SHIFT RIGHT 


021 D 


66 


22 




RORZ22 




021 F 


90 


0D 




BCC NAD 


- NO ADD IF THE 0/P BIT ISN'T A ONE 


0221 


18 






CLC 




0222 


A5 


20 




LDA Z 20 


- TWO BYTE ADD 


0224 


65 


24 




ADC Z 24 




0226 


85 


24 




STA Z 24 




0228 


A5 


21 




LDA Z 21 




022A 


65 


25 




ADC Z 25 




022C 


85 


25 




STA Z 25 


- NO CARRY OUT OF THE ADD 


022E 


66 


25 


NAD 


RORZ25 


- SHIFT AGAIN 


0230 


66 


24 




ROR Z 24 




0232 


88 






DEY 




0233 


D0 


E6 




BNE LOOP 


- GO ROUND LOOP 16 TIMES 


0235 


66 


23 




ROR Z 23 


- FINALSHIFT ON RESULT 


0237 


66 


22 




ROR Z 22 




0239 


A0 


06 




LDY #06 


- SET UP POSITION 


023B 


20 


66 


FE 


JSR QHEXTD2 


- X ALREADY POINTING AT 

CORRECT LOCATIONS - PUT 4 HEX 
OUT 


023E 


A0 


02 




LDY #02 


- NEXT POSITION 



4.3.INDIRECTION: 

YOU'LL NOTICE THAT THE PROGRAM IS NOT POSITION INDEPENDENT: THE 
ADDRESS OF THE CLC INSTRUCTION MUST BE WRITTEN INTO THE PROGRAM. 
THIS IS ANOTHER DISADVANTAGE OF THIS METHOD: (THERE IS AN 
ADVANTAGE: THIS PROGRAM IS VERY FAST, TAKING ONLY 6mS PER BYTE). 
THE INSTRUCTION REQUIRED MUST HAVE A 16 BIT UNFIXED ADDRESS AND 
THIS CAN ONLY GO IN ONE PLACE : MEMORY. A LIMITATION IS THAT 
GENERALLY IT CAN ONLY BE IN ZERO PAGE MEMORY. THE CONCEPT IS 
KNOWN AS INDIRECTION. THE MOST DIRECT VERSION OF THIS IS THE 
INDIRECT JUMP . 
6C 02 00 JMP (0002) 

THIS IS THE ONE VERSION OF INDIRECTION THAT DOESN'T NEED TO REFER 
TO ZERO PAGE MEMORY. WHAT HAPPENS IS THIS: 



TIME,mS 


ADDRESS BUS 


DATA BUS 


R/W 





PC 


6C 


1 JUMP INDIRECT 


1 


PC+1 


02 




2 


PC+2 


00 




3 


0002 


V 


1 LOWER BYTE 


4 


0003 


U 


HIGHER BYTE 


5 


UV 


OPCODE 


OLD 6C COMPLETED 



THE MONITOR USES A JUMP INDIRECT FOR THE GO FUNCTION, HAVING 
BUILT THE ADDRESS IN 0002 & 0003 : A JUMP INDIRECT VIA 0002 & 0003, 
ASSUMING THATTHESE LOCATIONS HAVEN'T BEEN ALTERED, WILL THUS 
RETURN TO THE START OF THE PROGRAM -WITHOUT KNOWING WHERE 
IT HAD BEEN ENTERED INTO MEMORY AT THE TIME OF WRITING. 
INDIRECT JUMP 



MAIN PROGRAM 
JMP (0002) 


ZERO PAGE 

12 0002 

34 ; 0003 

4 




XX 
XX 
XX 


ROUTINE 

1234 
1235 
1236 



WELL,THAT WAS SIMPLE INDIRECTION. NOW WE'LL MOVE ONTO THE MORE 
COMPLICATED MODES OF INDIRECTION. HAVING FETCHED THE ADDRESS 
OUT OF MEMORY WITH THE INDIRECTION STAGE, WE CAN INDEX IT. THIS IS 
CALLED POST-INDEXED INDIRECTION. WITH THE 65XX SERIES OF MICRO- 
PROCESSORS YOU MAY ONLY 

I INDEX IN THIS MODE WITH THE Y INDEX REGISTER 

II USE ZERO PAGE MEMORY 



"IM[ 


-z,(jiS ADDRESS BUS 


DATA BUS F 





PC 


81 1 


1 


PC+1 


I 1 


2 


001 


J 1 


3 


001+1 


K 1 


4 


KJ+Y 


DATA 1 


5 


PC+2 


OPCODE 1 



R/W 



LDA (I),Y 



(AN EXTRA juS IS NEEDED I F J+Y 
RESULTS IN A CARRY) 
THIS IS THE MODE OF ADDRESSING NEEDED TO SOLVE THE 65536 BYTE 
ADDITION PROBLEM. MEANWHILE WHAT ABOUT THE X REGISTER AND 
INDIRECTION? HERE WE HAVE PRE-INDEXED INDIRECTION 
TIME,mS ADDRESS bus DATA BUS R/W 

PC A1 1 LDA (I,X) 

1 PC+1 1 1 

2 001 DATA, 1 

DISCARDED 

3 00I+X J 1 

4 00I+X+1 K 1 

5 KJ DATA 1 

6 PC+2 OPCODE 1 

THIS IS THE OPPOSITE TO POST-INDEXED ...HERE THE INDEXING SWITCHES 
BETWEEN DIFFERENT INDIRECTION LOCATIONS. THE EFFECTS OF THESE 
TWO INDEXING MODES ARE ONLY THE SAME IN THE TRIVIAL CASE OF ZERO 
INDEXES. HERE IS THE SOLUTION TO THE 65536 BYTE ADDITION: 



NO CARRY TO HIGH ORDER BYTE 



PUT I N A 



98 


TYA 


85 20 


STA Z 20 


85 21 


STA Z 21 


18 LOOP 


CLC 


71 20 


ADC (20), Y 


C8 


INY 


D0FA 


BNE LOOP 


E6 21 


INC Z 21 


D0F6 


BNE LOOP 


2060 FE 


JSR FE60 


4C04FF 


JMP FF04 



-ZERO Y& A 

SET UP INDIRECT LOCATIONS 



THE PROGRAM IS, ONCE AGAIN, POSITION INDEPENDENT. IT IS, AS IMPLIED IN 
THE FIRST SOLUTION, SLOW : 12juS PER BYTE. THIS IS MAINLY DUE TO THE 
SMALL SIZE OF THE LOOP : THE 3mS 'NEARLY ALWAYS TAKEN' BRANCH IS 
TAKING A DISPROPORTIONATE AMOUNT OF TIME, IN THE FIRST SOLUTION 
THE EQUIVALENT 5iuS BRANCH AND JUMP COMBINATION OCCURS ONLY 
EVERY 256 BYTES AND IS THUS IGNORED IN THE TIME CALCULATIONS. 
THE INSTRUCTION INC Z 21 HAS AN OBVIOUS FUNCTION : INCREMENT (IN 
HEXADECIMAL) LOCATION 0021. IT ACTS JUST LIKE INX OR INY -BUT IT 
TAKES 5mS instead OF 2mS. 

4.4 READ-MODIFY WRITE INSTRUCTIONS 

THERE ARE COMPANION INSTRUCTIONS TO INC Z THAT CAN DIRECTLY 
ALTER MEMORY CONTENTS, THESE ARE CALLED READ-MODI FY-WRITE 
INSTRUCTIONS,THE NEXT OF WHICH IS THE OBVIOUS DEC INSTRUCTION. 



ADDR 


HEX LABEL 
CODE 


INSTRUCTION 


COMMENTS 


0217 


A4 


20 


LDY i 20 


- USE Y & X AS DOUBLE 
ACCUMULATOR 


0219 


A6 


21 


LDXH21 




0218 


38 




SUB SEC ^ 




021 C 


98 




TYA 




021 D 


E5 


22 


SBC Z 22 


> - SUBTRACT THE DIVISOR 


021 F 


A8 




TAY 




0220 


8A 




TXA 




0221 


E9 


00 


SBC #00 




0223 


AA 




TAX > 




0224 


90 


10 


BCC RESULT 


- IF NEGATIVE THEN FINISHED 


0226 


84 


23 


STY 2 23 


- ELSE UPDATE THE REMAINDER 


0228 


A5 


24 


LDA 2 24 ^ 




022A 


69 


00 


ADC #00 




022C 


85 


24 


STA Z 24 


> - AND ADD ONE TO THE RESULT 


022E 


A5 


25 


LDA Z 25 


(CARRY WAS SET ON INPUT). 


0230 


69 


00 


ADC #00 




0232 


85 


25 


STA 2 25 / 




0234 


90 


E5 


BCC SUB 


- NO CARRY IS POSSIBLE (USUALLY) 


0236 


A2 


24 RESULT 


LDX #24 




0238 


20 


64 FE 


JSR QHEXTDI 


- DISPLAY RESULT 


023B 


A5 


23 


LDA Z 23 




023D 


20 


60 FE 


JSR RDHEXTD 


- AND REMAINDER 


0240 


4C 


04 FF 


JMP RESTART 




0242 











THE TWO MULTIPLY ROUTINES ARE FOR SINGLE AND DOUBLE BYTE BINARY 
MULTIPLICATION. THE FIRST PROMPTS XX0011XX AND THE TWO NUMBERS 
TO BE MULTIPLIED SHOULD BE ENTERED SEQUENTIALLY. (E.G. 1234 WOULD 
GIVE 12 X 34). THE SECOND PROMPTS XX0000XX FOLLOWED BY XX1 11 1XX 
FOR THE TWO NUMBERS. ANSWERS ARE, AS USUAL, DISPLAYED AFTER A 
CONTROL KEY HAS BEEN PRESSED. 

BOTH ARE BASED ON AN EQUIVALENT TO THE NORMAL METHOD OF LONG 
MULTIPLICATION. 

E.G. 11010 

00110 







0000000000 


-(0X2*) X 11010 






00000000(J 


-(0X2') X 11010 






1101000 


-(1 X2^) X 11010 






110100 


-(1X2) X11010 






000000 


-(0X2") X 11010 






10011100 




SINGLE BYTE MULTIPLY 






ADDR 


HEX LABEL 
CODE 


INSTRUCTION 


COMMENTS 


0200 


D8 


CLD 




0202 


84 20 


STY 2 20 


- SET UP PROMPT FOR ZERO 
MULTIPLIER 


0204 


A9 11 


LDA #11 




0206 


85 21 


STA Z 21 


- PROMPT FOR FIRST- MUl 



ADDR 


HEX 




LABEL 


INSTRUCTION COMMENTS 




CODE 








020F 


84 


23 




STYHSUBL 


- SUBTRACT 0001 AT START 


0211 


A4 


20 




LDYZSGL 


- USE Y& X ASDOUBLESIZED 
ACCUMULATOR 


0213 


A6 


21 




LDX H SON 




0215 


38 




NXTSUB 


SEC 




0216 


98 






TYA 




0217 


E5 


23 




SBCZSUBL 




0219 


A8 






TAY 


> - SUBTRACT SUB FROM X& Y 


021 A 


8A 






TXA 




021 B 


E5 


24 




SBCESUBH 




021 D 


AA 






TAX ^ 




021 E 


90 


14 




BCC RESULT 


- IF NEGATIVE THEN STOP 


0220 


A9 


00 




LDA#00 


- NOTFINISHED YET. INCREMENT 
ROOT 


0222 


65 


22 




ADC 2 ROOT 




0224 


85 


22 




STA Z ROOT 




0226 


A5 


23 




LDAZSUBL 


- INCREMENT SUB 


0228 


69 


02 




ADC #02 




022A 


85 


23 




STAHSUBL 




022C 


A5 


24 




LDAHSUBH 




022E 


69 


00 




ADC #00 




0230 


85 


24 




STA2SUBH 




0232 


90 


El 




BCC NXTSUB 


- THERE CAN BE NO CARRY: 
BRANCH ALWAYS 


0234 


A5 


22 


RESULT 


LDA 2 ROOT 




0236 


20 


60 


FE 


JSR DHEXTD 


- DISPLAY ANSWER 


0239 


4C 


04 


FF 


JMP RESTART 


024B 













THE DIVIDE ROUTINE WILL CALCULATE THE INTEGER RESULT AND 
REMAINDER OF A FOUR DIGIT NUMBER DIVIDED BY A TWO DIGIT NUMBER. 
BY ENTERING CLD (FOR HEX.) OR SED (FOR DECIMAL) EITHER BASE MAY BE 
USED, SINCE ITWORKS BY SUBTRACTING THE DIVISOR SUCCESSIVELY FROM 
THE DIVIDEND. THE ROUTINE PROMPTS WITH XX0000XX FOR THE DIVIDEND 
AND THEN XXXX11XX FOR THE DIVISOR. THE ANSWER WILL APPEAR IN 
THE FORM ABCD.EF WHERE ABCD IS THE INTEGER RESULT AND EF IS THE 
REMAINDER. 



DIVIDER 






ADDR 


HEX 
CODE 


U 


0200 


D8 


OR 


F8 


0201 


84 


20 




0203 


84 


21 




0205 


A9 


11 




0207 


85 


22 




0209 


A2 


20 




020B 


20 


88 


FE 


020E 


A2 


22 




0210 


20 


88 


FE 


0213 


84 


24 




0215 


84 


25 





LABEL 



INSTRUCTION 

CLD OR SED 

STY 2 20 DIVIDED 

STY 2 21 

LDA #11 

STA 2 22 DIVISOR 

LDX #20 

JSR ODATFET 

LDX #22 

JSR ODATFET 

STY 2 24 RESULT 

STY 2 25 



COMMENTS 

- BINARY (DECIMAL) OPERATION 

- CLEAR DIVIDEND -PROMPT FOR 
NUMBER 

- PROMPT FOR SECOND NUMBER 



THE OTHER FOUR ARE NEW, THEY ARE SHI FTS AND ROTATES. LET'S USE ASL 
AS AN EXAMPLE 

LOAD A IMMEDIATE WITH 55 

ARITHMETIC SHIFT LEFT 

JUMP TO SUBROUTINE 

JUMP 

THE RESULT OF RUNNING THIS PROGRAM IS AA ON THE DISPLAY. EACH BIT 
IN THE ACCUMULATOR HAS BEEN SHIFTED ONE BIT LEFT. 



0070 


A9 55 


LDA # 55 


72 


0A 


AS LA 


73 


20 60FE 


JSR FE60 


76 


4C04FF 


JMP FF04 



BEFORE 
AFTER 



A 
01010101 



10101010 







ROLA, ROTATE LEFT ACCUMULATOR, (2A) WILL HAVE THE SAME EFFECT, 
EXCEPT THAT THE RIGHT INPUT IS REPLACED BY C, IN THIS CASE 1,S0 
THE RESULT ISAB. 
LSRA,LOGICAL SHIFT RIGHT ACCUMULATOR (4A) 

C 

01010101 



BEFORE 
AFTER 



10101010 



K 



fe^-' 



M/- 



RORA, ROTATE RIGHT ACCUMULATOR (6A) WILL REPLACE THE LEFT INPUT 
WITH C TO GIVE AA 

ALL THESE INSTRUCTIONS MAY BE USED DIRECTLY ON MEMORY LIKE INC 2. 
4.5 MISCELLANEOUS REMAINING INSTRUCTIONS 

THERE ARE A FEW INSTRUCTIONS LEFT, WHICH WILL HAVE TO BE DEALT 
WITH PIECE-MEAL: 

BRK00 : THE MICROPROCESSOR HAS TWO INTERRUPTS, AS EXPLAINED IN 
THE HARDWARE SECTION, AND THE INSTRUCTION SIMULATES AN 
yJRQ, FIRST SETTING THE B FLAG IN THE STATUS REGISTER. THE 
"RETURN AFTER A BREAK WILL BE AT THE NEXT BUT ONE BYTE 
: A COMBINATION OF TWO INSTRUCTIONS 

I READ MEMORY BITS 6 & 7 INTO THE OVERFLOW & 
NEGATIVE FLAGS 

II LOGICAL AND ACCUMULATOR AND MEMORY, A ZERO 
RESULT SETTING THE Z FLAG. THE RESULT IS NOT 
LOADED INTO THE ACCUMULATOR. THE INSTRUCTION 
IS USUALLY USED TO TEST THE STATUS OF 
PERIPHERAL DEVICES, WITHOUT UPSETTING A,X OR Y. 

RTS 40, 60 BOTH INSTRUCTIONS PULL THE PROGRAM COUNTER FROM 
THE STACK, RTI FIRST PULLS THE PROCESSOR STATUS 
FROM THE STACK. 



^2C 



RTI 

1 



.J 






- FETCH DIVIDEND 

- FETCH DIVISOR 

- CLEAR RESULT 



CHAPTER 5: ACORN HARDWARE 
5.1 CHIP LAYOUT AND BUS 

BEFORE PLUNGING DEEPER INTO SOFTWARE WE'LL TAKE A REST AND LOOK 
AT THE HARDWARE. WE'LL START WITH THE CPU BOARD 
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ROUTINES BY ENTERING THE SECTION OF PROGRAM FROM THE TITLE LABEL 
(E.G. DIVIDE) TO THE RESULT LABEL AND SUBSTITUTING THE LINE 

60 RESULT RTS . 
ALL ARE RELOCATABLE. 

SYSTEM PROGRAMS 

THESE PROGRAMS ARE ALL SHORT ROUTINES WHICH CAN PROVE USEFUL 
TIME SAVERS AT THE DEVELOPMENT AND INPUT STAGES OF PROGRAM 
WRITING. 

IT MAY BE FOUND USEFUL TO KEEP COPIES OF THEM ON TAPE AND TO HAVE 
THEM IN THE ACORN AND BESIDE YOU WHILE DEVELOPING PROGRAMS. 
BRANCH CALCULATIONS IN PARTICULAR ARE A FERTILE SOURCE OF 
ERRORS AND TIME WASTING IN ANY HAND ASSEMBLED PROGRAM. 
THE RELOCATOR Wl LL MOVE PROGRAMS AROUND MEMORY FOR YOU. A 
GODSEND TO ANYONE WHO FINDS THEMSELVES WITH THE NEED TO 
REENTER LARGE CHUNKS OF CODE MANUALLY. 

MISCELLANEOUS 

THIS IS A SELECTION OF PROGRAMS AND ROUTINES INCLUDED BECAUSE 
THEY ARE INTERESTING, ELEGANT OR IMPORTANT. THEY SHOW SOME OF 
OF THE THINGS THAT CAN BE DONE WITH THE SYSTEM, WHICH MAY BE MORE 
THAN YOU IMAGINE. WE HAVE, FOR INSTANCE, RUN A CHESS GAME IN THE IK 
SYSTEM. 

IN PARTICULAR THE METRONOME AND COUNTER PROGRAMS ARE INTENDED 
TO DEMONSTRATE SOME OF THE USES OF THE KEYBOARD. IN ORDER TO 
UNDERSTAND WHAT IS GOING ON WITH THESE PROGRAMS YOU WOULD BE 
WELL ADVISED TO STUDY THE MONITOR LISTING AND PART 1 OF THIS 
MANUAL. 

MATHEMATICAL 

THE SQUARE ROOT PROGRAM WILL CALCULATE EITHER DECIMAL OR HEXA- 
DECIMAL SQUARE ROOTS ACCORDING AS CLD (FOR HEX) OR SED (FOR 
DECIMAL) IS ENTERED AS THE FIRST LINE. IN EITHER CASE THE PROMPT 
Wl LL BE XX0000XX . THE SQUARE SHOULD BE ENTERED, A CONTROL KEY 
PRESSED AND THE ROOT Wl LL APPEAR ON THE DISPLAY. 
THE PROGRAM IS BASED ON THE EQUALITY 

((N+1)*(N+1))-(N*N)=(2*N)+1 
AND SUCCESI VELY SUBTRACTS 1 ,3,7,9 ETC. FROM THE SQUARE. WHEN THE 
RESULT OF A SUBTRACTION GOES NEGATIVE THE NUMBER OF SUBTRACTIONS 
DONE TO DATE IS THE ROOT. 
HEX/DEC SO ROOT. 



ADDR 


HEX 




CODE 


(9200 


F8 OR 


0201 


84 21 


0203 


84 20 


0205 


A2 20 


0207 


20 88 



LABEL 



D8 



FE 



020A 84 24 



020C 
020E 



84 
C8 



22 



INSTRUCTION 

SED (OR CLD) 
STY 2 SQH 
STY Z SQL 
LDX #SQL 
JSR QDATFET 

STYZSUBH 

STY 2 ROOT 
INY 



COMMENTS 



RELOCATABLE 



SETDECIMAL (BINARY) OPERATING 
CLEAR SQUARE TO PROMPT 



FETCH THE NO. WHOSE ROOT IS TO 

BE FOUND 

CLEAR HIGH PART OF 

SUBTRACTING NO. 

CLEAR ROOT 



PART 2 
APPLICATION PROGRAMS 
MATHEMATICAL 

1. SQUARE ROOT (HEX. OR DECIMAL) 

2. DIVIDE (HEX. OR DECIMAL) 

3. SINGLE BYTE MULTIPLY 

4. DOUBLE BYTE MULTIPLY 
SYSTEM 

1. DECIMAL TO HEX. 

2. HEX. TO DECIMAL 

3. BRANCH OFFSET CALCULATOR 

4. RELOCATOR 

5. TAPE USE PROGRAMS 

6. SCROLL 
GAMES 

1. NIM 

2. DUCK SHOOT 
MISCELLANEOUS 

1. COUNTER 

2. KEYBOARD COUNTER ROUTINE 

3. METRONOME 

4. EIGHT QUEENS PROBLEM 

GENERAL 

THESE APPLICATIONS PROGRAMS ARE INTENDED TO DEMONSTRATE SOME 

OF THE CAPABILITIES OF THE SYSTEM AND OF THE PROCESSOR. THEY HAVE 

BEEN DESIGNED FOR CLARITY AND SIMPLICITY AND IN MANY CASES ARE 

NOT OPTIMAL EITHER IN TERMS OF LENGTH OF PROGRAM OR OF EXECUTION 

TIME. THEY ARE INTENDED SIMPLY TO GIVE YOU A FEEL FOR THE SYSTEM 

AND SOMEWHERE TO START OFF FROM. 

ALL PROGRAMS MARKED RELOCATABLE CAN BE ENTERED ANYWHERE IN 

AVAI LABLE MEMORY, SUBJECT TO NOT IMPINGING IN VARIABLE STORAGE 

SPACE FOR EITHER THE PROGRAM OR MONITOR AND NOT USING SPACE 

NEEDED BY THE STACK. (FOR STACK USAGE SEE RELEVANT SECTIONS OF 

PARTI OF THIS MANUAL.) 

AS FAR AS HAS PROVED POSSIBLE THE CONVENTION OF A XX 0000 XX 

PROMPT FOR THE FIRST NUMBER TO BE ENTERED AND XX 1111 XX FOR THE 

SECOND HAS BEEN OBSERVED IN THESE PROGRAMS. AFTER ENTERING A 

NUMBER CHECK THAT IT IS CORRECT AND THEN PRESS A CONTROL KEY 

(ANY ONE Wl LL DO) TO PROGRESS THROUGH THE PROGRAM. 

YOU SHOULD NOW BE READY TO TYPE IN THE PROGRAMS AND RUN THEM, 

BOTH TO ASSURE YOURSELF THAT THE SYSTEM IS OPERABLE AND TO 

FAMILIARISE YOURSELF WITH ITS OPERATION. 

THROUGHOUT THESE NOTES X INDICATES AN UNDEFINED/UNIMPORTANT 

CHARACTER. 

MOST OF THE PROGRAMS WERE WRITTEN BY MARK I'ANSON, THANK YOU 

MARK I. 

MATHEMATICAL PROGRAMS 

ALL THESE ROUTINES RESET THEMSELVES WHEN A CONTROL KEY IS PRESSED 
AFTER THE NUMBER HAS BEEN OBTAINED THEY MAY ALL BE USED AS SUB 



THE OBVIOUS IMPORTANT DEVICE HERE IS A, THE MICROPROCESSOR. THIS IS 
WHERE A,X,Y,P,S,PC LIVE. FROM HERE COME THE COMMANDS TO RUN 
EVERYTHING ELSE. THERE ARE TWO PRIMARY BUSSES, CONSISTING OF 
PARALLEL PATHS OF BINARY DATA, THE BIGGEST BUS IS THE ADDRESS BUS . 
THIS CONSISTS OF 16 LINES TO TRANSFER THE ADDRESS GENERATED BY 
THE PROCESSOR TO THE ADDRESS INPUTS OF ALL OTHER SYSTEM CHIPS. 
THIS BUS IS UNIDIRECTIONAL : ONLYTHE PROCESSOR (IN A NORMAL 
SYSTEM) GENERATES ADDRESSES, AND IT HAS 2'* STATES (=65536,) THE 
SECOND BUS IS THE DATA BUS . THIS IS 8 BI-DIRECTIONAL LINES, ALLOWING 
A SINGLE WORD/BYTE TO BE TRANSFERRED EITHER FROM THE PROCESSOR 
TO MEMORY -A WRITE , OR FROM MEMORY TO PROCESSOR -A READ. 
THE REMAINING BUS IS THE CONTROL BUS , ITS MEMBERS HAVE NO 
PARTICULAR RELATIONSHIP WITH EACH OTHER, BUT THEY ARE ALL SUPER- 
VISORY SIGNALS FOR THE SYSTEM. THE FIRST CONTROL SIGNAL IS THE R/W 
LINE. THIS SPECIFIES THE TYPE OF DATA TRANSFER THAT THE PROCESSOR 
WISHES TO MAKE: WHEN THE R/W LINE IS HIGH (LOGIC ONE; > 2.4 V DC) THE 
PROCESSOR IS READING WHEN THE R/W LINE IS LOW (LOGIC ZERO <0.8 V DC) 
THE PROCESSOR ISWRITINGJHE NEXT CONTROL LINES ARE THE SYSTEM 
CLOCK, WHICH CONTROLS THE TIMING OF ALL DATA TRANSFERS. THE 
PROCESSOR, WITH HELP FROM 1/6 OF A TTL IC, GENERATES THE SYTEM 
CLOCK AS TWO NON-OVERLAPPING SQUARE WAVES, PHASE ONE (01) & PHASE 
TWO (02) ^ 



01 



02 



DURING 01 THE ADDRESS BUS AND THE R/W LINE CHANGE, AT THE END OF, 
OR DURING, 02 THE DATA IS TRANSFERRED. OTHER CONTROL SIGNALS ALSO 
CHANGE AT TIMES SPECIFIED WITH RESPECT TO THE SYSTEM CLOCK, E.G. 
THE SYNC SIGNAL : THIS GOES HIGH DURING 01 WHEN THE PROCESSOR IS 
FETCHING AN INSTRUCTION, AND RETURNS LOW WITH THE TRAILING EDGE 
OF 02. 



5.2 RESET. INTERRUPT REQU EST AN D NON-MASKABLE INTERRUPT 

ANOTHER CONTROL LINE IS RESET. THIS IS GENERATED BY SUITABLE HARD- 
WAREdN THE ACORNTHE CORNER SWITCH ON THE CPU BOARD, AND THE RE- 
SET JWITCH ON THE KEYBOARD,) ANDCAUSES ALL PARTS OF THE SYSTEM TO 
BE RESET TO A SAFE, KNOWN STATE. IN THE PROCESSOR'S CASE RESET 
INITIALIZES THE PROGRAM COUNTER TO THE CONTENTS OF ADDRESSES 
FFFC AND FFFD WHICH, FOR ACORN, CONTAIN THE ADDRESS FEF3. 
EXECUTION OF THE ACORN MONITOR STARTS THERE. PE RIPHER AL DEVICES 
SHOULD BE SET TO THEIR LEAST DANGEROUS STATE BY RESET, E.G. 
REMOVE INTERRUPT CAPABILITY.SET ALL PROGRAMMABLE INPUT/OUTPUT 
LINES TO INPUTS. 

THE TWO PUSH BUTTONS ON THE CPU BOARD ON EITHER SIDE OF THE RESET 
BUTTON ARE INTERRUPT BUTTONS. THE IDEA OF AN INTERRUPT IS TO 
PULL THE PROCESSOR AWAY FROM IT'S CURRENT TASK, LET IT BRIEFLY DO 
SOMETHING IMPORTANT AND THEN RETURN TO IT'S TASK AS IF NOTHING 
HAD HAPPENED. THE 6502 HAS TWO DISTINCT INTERRUPT CAPABILITIES 
IRQ 

WITH AN INTERRUPT REQUEST . IRQ, THE PROCESSOR HAS THE OPTION OF 
IGNORING IT. AN IRQ IS ONLY GRANTED IF THE FLAG I (INTERRUPT 
DISABLE) IN THE PROCESSOR STATUS REGISTER IS 0. THE PROCESSOR 
THEN PUSHES PC&P& THEN SETS 1 TO 1. (THE STATE OF THE IRQ LINE IS 
CHECKED BETWEEN INSTRUCTIONS ... IF IT REMAINS LOW.WE DON'T 
WANT ANOTHER INTERRUPT). THEN THE PROCESSOR LOADS PC FROM 
LOCATIONS FFFE & FFFF AND CONTINUES. NOTE THAT AN RTI RETURNS 
THE ORIGINAL P, WHICH HAD THEI FLAG 0. 
NMI 

WITH A NON-MASKABLE INTERRUPT . NMI, THE PROCESSOR HAS NO 
OPTIONS; WHEN THE LINE HAS BEEN LOW FOR AT LEAST TWO CLOCK 
CYCLES, THE PROCESSOR Wl LL FINISH ITS CURRENT INSTRUCTION, SAVE 
ITS STATUS & PC, SETIHIGH AND FETCH A NEW PC FROM FFFA& FFFB. 
TO AVOID RECOGNISING ANOTHER INTERRUPT NMI IS EDGE-SENSITIVE: 
NO FURTHER INTERRUPTS ARE RECOGNISED UNTIL NMI HAS RETURNED 
HIGH. SINCE NMI SETS I HIGH, IRQ WILL NOT SUCCEED DURING THE 
NORMAL OPERATION OF AN NMI PROGRAM, BUT NMI WILL BE ABLE TO 
TAKE CONTROL DURING EXECUTION OF AN IRQ PROGRAM; IT HAS A 
HIGHER PRIORITY. 
IRQ, NMI, & RESET ARE OPEN-COLLECTOR LINES ON THE CPU BOARD: MANY 
INTERRUPTING/RESETTING DEVICES MAY BE CONNECTED. 



— +5V 
4K DEVICE 1 



RST, IRQ, NMI J 




OV 



^ 



DEVICE 2 



FFB3 


85 


0A 




BREAK 


STA Z R0 


B5 


86 


0B 






STX Z R1 


B7 


84 


00 






STY Z R2 


B9 


68 








PLA 


BA 


48 








PHA 


BB 


85 


0D 






STA E R3 


BD 


A2 


0D 






LDX#R3 


BF 


A9 


FF 






LDA # FF 


CI 


85 


0E 






STA Z REPEAT 


C3 


20 


00 


FE 




JSR QUAD 


C6 


BA 








TSX 


C7 


86 


13 






STX H R7 


C9 


C8 








INY 


CA 


84 


12 






STY Z R6 


CC 


D8 








OLD 


CD 


BD 


02 


01 




LDA, X 0102 


D0 


38 








SEC 


D1 


E5 


1? 


iC 


1" F, ir-- 


SBC^ RECAL 


D3 


9D 


02 


01 




STA, X 0102 


D6 


85 


11 






STA Z R5 


D8 


BD 


03 


01 




LDA, X 0103 


DB 


E9 


00 






SBC #00 


DD 


9D 


03 


01 




STA, X 0103 


E0 


85 


10 






STA Z R4 


E2 


A2 


13 






LDX #R7 


E4 


20 


00 


FE 




JSR QUAD 


FFE7 


4C 


07 


FF 




JMP RE-ENTER 


FFEA 


3F 


06 


5B 


4F FONT 


'0"1"2"3' 


EE 


66 


6D 


7D 


07 


•4' -5' '6' 7' 


F2 


7F 


6F 


77 


7C 


'8' '9' 'A' 'b' 


F6 


58 


5E 


79 


71 


'c' 'd' 'E' 'F' 


FFFA 


AD 


FF 




NMIVEC 


NMI 


FFFC 


F3 


FE 




RSTVEC 


RESET 


FFFE 


80 


FF 




IRQVEC 


IRQ 



WHEN THE IRQ/BREAK VECTOR 

POINTS HERE THEN DISPLAY 
DISPLAY EVERYTHING - SAVE A 

SAVEX 

SAVE Y 

GET P OFF STACK 

PUT IT BACK FOR FUTURE USE 

STORE Q IN REGISTERS 

SET X TO POINT AT REGISTERS 

3^0 FOR QUAD 

KILL POSSIBILITY OF DISPLAY 

BEING ON SINGLE SCAN 

USE QUAD TO WRITE OUT A X Y P 

GET STACK POINTER 

Y ZERO SINE QUAD ENDED WITH 
DISPLAY SO THIS FORMS 01 

CLEAR DECIMAL MODE FOR BINARY 
SUBTRACT - DOESN'T AFFECT 
USER SINCE P IS STACKED 
GET PCL OFF STACK 

CORRECT IT BY AMOUNT IN RECAL 

PUT IT BACK ON STACK 

AND STORE IT FOR QUAD 

PCH OFF STACK 

REST OF TWO BYTE SUBTRACTION 

PUT IT BACK ON STACK 

AND STORE IT FOR QUAD 

POINT X AT THESE REGISTERS - 

QUAD WILL DESTROY THEM 

QUAD WRITES OUT PC SP 

AND THE WHOLE SHEBARG STARTS 

OVER AGAIN 

7 SEGMENT FORMS OF THE HEX 

DIGITS 



POINT TO THE ADDED INDIRECTION 
POINT TO THE RESET ENTRY POINT 
POINT TO THE ADDED INDIRECTION 



FF45 


20 


5E 


FE 


'MODIFY' 


JSR MHEXTD 


48 


20 


0C 


FE 




JSR DISPLAY 


4B 


B0 


BC 






BCS SEARCH 


4D 


A1 


00 






LDA (00, X) 


4F 


0A 








ASLA 


50 


0A 








ASLA 


51 


0A 








ASLA 


52 


0A 








ASLA 


53 


05 


f:^ 


-* i> 


,1. f OM 


0RA2 KEY 


55 


81 


00 






STA(00,X) 


57 


4C 


45 


FF 




JMP "MODIFY" 


FF5A 


D0 


03 




N1 


BNE N2 


FF5C 


6C 


02 


00 


"GO" 


JMP (GAP) 


FF5F 


E0 


04 




N2 


CPX #04 


61 


F0 


36 






BEQ POINT 


63 


A2 


08 




"STORE" 


LDX #08 


65 


86 


10 






STXZD 


67 


20 


88 


FE 




JSR QDATFET 


FF6A 


A2 


04 






LDX #04 


FF6C 


85 


05 




Pr:,l^ 


- LDA 2, X 05 


6E 


20 


B1 


FE 




JSR PUTBYTE 


71 


CA 








DEX 


FF72 


D0 


F8 






BNE ADDRESS 


FF74 


A1 


06 




DATAS 


LDA (06, X) 






^«) 1- 


iLIVN 




76 


20 


\3^ 


FE 




JSR PUTBYTE 


79 


20 


A0 


FE 




JSR COM 16 


7C 


D0 


F6 






BNE DATAS 


7E 


F0 


2A 






BEQ WAYOUT 


FF80 


A2 


04 




"LOAD" 


LDX #04 


FF82 


70 


DD 


FE 


ADDRSL 


JSR GETBYTE 


85 


95 


05 






STA2,X05 


87 


CA 








DEX 


88 


n0 


F8 






BNE ADDRSL 


FF8A 


?0 


DD 


FE 


DATAL 


JSR GETBYTE 


8D 


81 


06 






STA (06, X) 


8F 


8D 


21 


0E 




STA1PIB 


92 


20 


A0 


FE 




JSR COM 16 


95 


D0 


F3 






BNE DATAL 


97 


F0 


11 






BEQ WAYOUT 


FF99 
9B 


A1 
F0 


00 
06 




"POINT" 


LDA (00, X) 
BEQ SET 



90 85 18 

9F A9 00 

A1 F0 02 

FFA3 A5 18 SET 

FFA5 81 00 OUT 

A7 20 5E FE 



STAZP 

LDA #00 
BEQ OUT 
LDAZP 

STA (00, X) 

JSR MHEXTD 



FFAA 4C 04 FF WAYOUT JMP RESTART 
FFAD 6C 1C 00 NMI JMP (USERNMI) 

FFB0 6C IE 00 IRQ JMP (USERIRQ) 



DISPLAY THE MEMORY 
AND GET KEY 
IF NOT HEX DO OVER 
HEX SO GET OLD INFO 



MOVED ALONG 

AND PUT IN NEW INFO 

AND PUT IT BACK 

THEN KEEP DOING IT 

MUST BE 4 OR 6 AS 2 IS 

THE VERY SIMPLE GO 

IS IT 4 OR 6? 

WELL IT'S NOT 4 

SO IT MUST BE 6 - X NOW POINTS 

TO TAP 

GIVE PROMPT 

AND GET 2ND STORE INFO 

LOOP COUNT 

SEND ADDRESSES TO TAPE 



X NEATLY ZEROED ON EXIT 

DATA SEND - GET INFO FROM 

MEMORY 

AND SEND IT TO TAPE 

SEE IF PRINTED 

NO 

YES 

RESCUE ADDRESSES FROM TAPE 
PUT THEM IN FAP & TAP, THOUGH 
IT COULD BE ELSEWHERE 

X NEATLY SERVED AGAIN 

GET DATA FROM TAPE 

AND STORE IT IN MEMORY 

AND ON THE DISPLAY SO IT CAN BE 

SEEN 

SEE IF FINISHED 

NO 

YES 

SET/CLEAR BREAK POINT - GET 

DATA FROM ADDRESSED MEMORY 

IF ZERO BREAK POINT HAS 

ALREADY BEEN SET = MUST CLEAR 

IT 

NOT ZERO SO SAVE THE 

INFORMATION 

AND PUT IN A BREAK POINT 

WAS SET SO GET OLD 

INFORMATION BACK 

INSERT BREAK POINT OR OLD 

INFORMATION 

NOW READ IT OUT AGAIN TO 

REVEAL ROM 

GO BACK & DO ITALL OVER AGAIN 

INDIRECTION ON NMI 

INDIRECTION ON IRQ 



TO DECIDE WHICH DEVICE CAUSED AN INTERRUPT THE PROCESSOR CHECKS 
A STATUS REGISTER OF EACH DEVICE, USING THE BIJ INSTRUCTION TO TEST 
BIT 7 OF THE DEVICE. AFTER EXECUTING THE PROGRAM REQUIRED FOR A 
PARTICULAR DEVICE THE PROCESSOR RESETS THE DEVICE'S INTERRUPT 
BEFORE EXECUTING ITS RU- IF THE INTERRUPT LINE IS STILL LOW (IRQ) OR 
MAKES ANOTHER NMI THE WHOLE THING IS REPEATED. THIS PRIORITIES THE 
INTERRUPTS IN SOFTWARE. 



5.3 6502 INTERNAL ARCHITECTURE 



(4) 
IRQ 



REGISTERS 



(b) 
NMI 



ADDRESS 
BUS 



8- 
(9) 

1 - 

(10) 

2 - 

(11) 

3 - 
(12) 

4 - 
(13) 

5 - 
(14) 

6 - 
(15) 

7 " 
<^ (16) 

8 - 
117) 

9 - 
(181 

1(3 - 
(19) 

11 - 
(20) 

12 ■ 
(22) 

13 - 
(23) 

14 ■ 
(24) 

15 ■ 

(25) 




INDEX 
Y 



INDEX 



STACK 
S 



t 



SO 



Accumulator 
A 



Program „-, 
Counter '^'^'- 



PCH 



5» 



INPUT 
DATA 
LATCH 



DATA BUS 
BUFFER 



f^ = 



BYTE LINE 



= 1 BIT LINE 



( ) PIN NUMBER 



n 



(4(8) 
RST 



CONTROL 



L\ 



NTERRUP1 
ILOGIC 



JT 



"(8) 



•(1,21) 






PROCESS 
STATUS 
P 



-ROY (2) 



TIED HIGH ON ACORN 



•SYNC (7) 



- S.O. (38) 



TIED HIGH ON ACORN 



TIMING 
:0NTROL 



01 



CLOCK 
GENERATOR 



CLOCK Q. (o-,, 
INPUT " ''^" 



• 01 (3) 

- 02 (39) 

- R/W (34) 



INSTRUCTION 
REGISTER 



-• — ^1 



■*-2 
■*-3 
-^4 
-♦5 
-♦6 
_w7 



(33) 
(32) 
(31) 
(30) 
(29) 
(28) 
(27) 
(26) 



DATA 
BUS 



5.4 PROMS, EPROM, RAM, RAM I/O 

THE NEXT THINGS CONNECTED TO THE CPU ARE DEVICES D. THESE ARE 
PROMS: PROGRAMMABLE READ ONLY MEMORYS. EACH CONTAINS 512 X 4 
BITS OF INFORMATION WHICH HAS BEEN FIXED AS HALF OF THE ACORN 
MONITOR. SHORT OF CATASTROPHIC DESTRUCTION THERE IS NO WAY TO 
MAKE A 'HIGH' PART OF THE MEMORY 'LOW', BUT 'LOW' PARTS CAN BE 
PROGRAMMED 'HIGH' BY PASSING EXCESS CURRENT THROUGH A FUSE AND 
DESTROYING IT. IN NORMAL ACORN OPERATION THESE TWO DEVICES WILL 
BE ENABLED BY ANY ADDRESS IN THE RANGE F800 TO FFFF: THEY THUS 
OCCUR IN THE MEMORY FOUR SEPARATE TIMES, MORE ON THIS ANON. 
AKIN TO D, IS DEVICE E. THIS IS NOT PART OF THE KIT, BUT IS INTENDED 
TOBEA2048X8 EPROM: ERASEABLE PROGRAMMABLE READ ONLY MEMORY. 
LIKE THE PROM, THE EPROM CAN BE PROGRAMMED ALTHOUGH FUSES ARE 
NOT BLOWN BUT CHARGE IS STORED ON THE GATE OF A FIELD EFFECT 
TRANSISTOR (F.E.T.). THIS CHARGE CAN ONLY LEAK AWAY SLOWLY - ABOUT 
TEN YEARS, UNLESS THE GATE IS EXPOSED TO ULTRA-VIOLET LIGHT WHICH 
HAS ENOUGH ENERGY TO SET THE DEVICE BACK TO IT'S STANDBY STATE. 
(IF YOU MAKE ONE PROGRAM MISTAKE THE WHOLE DEVICE MUST BE 
ERASED TO ALLOW YOU TO CORRECT THE MISTAKE. STI LL, IT'S BETTER 
THAN NOT BEING ABLE TO CORRECT A MISTAKE AS WITH THE PROM). AN 
ENABLE SIGNAL IS PROVIDED BETWEEN F000 & F7FF FOR THIS DEVICE, OR 
ELSE IT MAY BE PROGRAMMED WITH A LARGER MONITOR AND ENABLED BY 
THE F800 - FFFF SIGNAL. SMALLER (1024 X 8 or 512 X 8) EPROMS MAY ALSO 
BE FITTED IN SOCKET E, BUT THESE OLDER DEVICES USUALLY REQUI RE 
ADDITIONAL POWER SUPPLIES, AND TWO MODIFICATIONS TO THE CIRCUIT 
BOARD ARE REQUIRED TO ALLOW THIS. 

THE LAST TYPE OF MEMORY ON THE CPU BOARD IS TYPE C. THIS IS A STATIC 
READ/WRITE MEMORY: INFORMATION CAN BE CREATED AND DESTROYED 
BY THE MICROPROCESSOR ITSELF, BUT ALL IS LOST WHEN THE POWER IS 
REMOVED. TOGETHER WITH THE DYNAMIC VERSION, THIS TYPE OF DEVICE 
HAS RECEIVED THE NAME RANDOM ACCESS MEMORY R.A.M., ALTHOUGH 
THEY ARE NO MORE RANDOM THAN P.R.O.M.S. OR E.P.R.O.M.S. DEVICES C 
ARE 1024X4 RAMS, TWO ARE REQUIRED LIKE THE TWO PROMS TO BUILD UP 
A WHOLE BYTE, AND THEY ARE ENABLED BY ADDRESSES IN THE RANGE 
0000 TO 03FF. THEY THUS CONTAIN ZERO PAGE & PAGE 1 , THE STACK PAGE, 
AS WELL AS TWO FURTHER PAGES. 

THE ENABLE SIGNALS FOR ALL I.C.S. ON THE CPU BOARD ARE PROVIDED BY 
THE LOGIC I.C.'S G. THESE I.C.S. DECODE CERTAIN RANGES OF ADDRESSES 
FROM THE ADDRESS BUS BY RECOGNISING A PATTERN ON HIGH ADDRESS 
LINES, E.G. FOR THE SIGNAL TO THE TWO RAM'S THE TOP 6 (A15-A10) 
ADDRESS LINES MUST BE LOW (LOGIC ZERO).THE SIGNALS ARE ALL 
BROUGHT TO THE SOCKET F, WHERE LINKS CAN BE MADE (OR A D.I.L 
HEADER USED) TO TAKE THE ENABLE SIGNALS AWAY TO THE CHOSEN 
DEVICES THUS MANY DIFFERENT SYSTEM CONFIGURATIONS CAN BE USED, 
FROM JUST THE TWO P.R.O.M.S AND DEVICE B1 , THROUGH TO BOTH C'S, B2 & 
E OR ANY COMBINATION. 

DEVICES B HAVE TWO FUNCTIONS. IN THE FIRST PLACE EACH CONTAINS A 
128X8 RAM, BRINGING THE CPU BOARD UP TO 1280 BYTES OF R.A.M. 
SECONDLY EACH HAS THE FACILITIES FOR MAKING TWO WORDS OF MEMORY 
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DEY 
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F6 
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F0 


DA 




BEQWAIT 


FEF3 
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FF 
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F6 
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STX 1BDDR 
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STX Z REPEAT 


FEFB 
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INIT 


LDY #80 


FD 
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FF 


94 
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STYZ,X REPEAT 


FF01 


CA 






DEX 


FF(82 


00 


FB 




BNE ROUND 


FF04 


20 


0C 


FE RESTART 


JSR DISPLAY 


FF(87 


90 


F2 


RE-ENTER 


BCC INIT 


FF(39 


29 


07 


SEARCH 


AND #07 


OB 


C9 
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CMP #04 


(8D 


90 


25 




BCC FETADD 


0F 
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6F 




BEG LOAD 


11 


C9 


06 




CMP #06 


13 


F0 


09 




BEQ "UP" 


15 


80 


0F 




BOS "DOWN" 


FF17 


A5 


0A 


"RETURN" 


' LDA Z R0 


19 


A6 


0B 




LDX H R1 


IB 


A4 


0C 




LDY Z R2 


ID 


40 






RTI 


FF1E 


F6 


00 


"UP" 


INCZ,X00 


20 


D0 


0C 




BNE ENTERM 


22 


F6 


01 




INCH,X01 


24 


B0 


08 




BCS ENTERM 


FF26 


B5 


00 


"DOWN" 


LDA Z,X 00 


28 


D0 


02 




BNE NODEC 


2A 


D6 


01 




DECZ,X01 


FF2C 


D6 


00 


NODEC 
(Ff^ ENTERM 


DEC Z,X 00 


FF2E 


20 


64 


JSR QHEXTD1 


31 


4C 


45 


FF^^ff ,.f^- 


JMP "MODIFY" 


FF34 


84 


16 


FETADD 


STY Z D+6 


36 


84 


17 




STY Z D+7 


38 


0A 






ASL A 


FF39 


AA 






TAX 


3A 


49 


F7 




EOR #F7 


3C 


85 


10 




STAZD 


3E 


20 


88 


FE 


JSR QDATFET 


41 


E0 


02 




CPX #02 


43 


B«) 


15 




BCSNI 



GET SAMPLE AUTO CARRY 
AND AUTO A 

KEEP GOING 

USE WAIT TO GET OUT ONTO THE 

THE SHOP BIT HIGH 

MAIN PROGRAM 

INITIALIZE STACK 

AND B DATA DIRECTION REGISTER 

MULTI-SCAN DISPLAY MODE 

THE FAMILIAR DOT ON THE 

DISPLAY 

ALL EIGHT DISPLAYS AND 

INITIALIZE EXEC 

Y USED FOR AMUSEMENT 

X ZERO ON EXIT, SO UP & DOWN 
IMMEDIATELY VALID 
MARK RETURN TO MONITOR POINT 
DISPLAY DISPLAY & GET KEY 
HEX KEY GETS THE DOTS BACK 
REMOVE ANY STRAY BITS 
(EFFECTIVELY SUBTRACT 10) 

KEYS OF VALUE LESS THAN 4 
NEED AN ADDRESS 
KEY 4 IS THE LOAD KEY 

KEY 6 IS UP 

& KEY 7 IS DOWN 

MUST BE KEY 5 - GET A BACK 

GETX BACK 

GET Y BACK 

GET P & PC BACK & CONTINUE 

FROM WHERE YOU WERE 

16 BIT INDEXED INCREMENT 



A BRANCH ALWAYS : THE CARRY 
WAS SET BY THE FF1 1 COMPARE 
16 BIT INDEXED DECREMENT 



NOW DISPLAY THE VALUE 

AND GET INTO THE MODIFY 

SECTION 

CLEAR DISPLAYS 6 

& 7 - Y WAS ZERO ON EXIT FROM 

DISPLAY 

DOUBLE A 

THE ZERO PAGE ADDRESSES MAP, 

GAP, PAP & FAP 

FIX UP DIGIT COMMAND SYMBOL 

FETCH THE ADDRESS, AUTO MAP, 
GAP, PAP OR FAP 
CHECK X TO FIND OUT WHICH 
COMMAND WE'RE DOING 
MUST BE 2, 4 OR 6- AS IS 
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RTS 


FE88 
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JSR OHEXT01 


SB 
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0C 


FE 




JSR DISPLAY 


BE 


80 


20 






8CS RETURN 
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A0 


04 






LOY #04 
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0A 








ASLA 


93 


0A 








ASLA 


94 


0A 








ASLA 


95 


0A 








ASLA 


FE96 


0A 






SHIFTIN 


ASLA 


FE97 


36 


00 






ROLZ,X00 


99 


36 


01 






ROLE,X01 


9B 


88 








DEY 


9C 


D0 


F8 






BNE SHIFTIN 


9E 


F0 


E8 






BEQQOATFET 


FEA0 


F6 


06 




COM 16 


INCZ,X06 


A2 


00 


02 






8NEN0INC 


A4 


F6 


07 




f<- 


INC2,X07 


FEA6 


B5 


06 




UDINC 


LOA Z,X 06 


A8 


D5 


(B- 


og 


,^.^or^ 


CMP 2, X 08 


AA 


D0 


04 






BNE RETURN 


AC 


85 


07 






LDAZ,X07 


AE 


05 


09 






CMP 2,X 09 


FEB0 


60 






RETURN 


RTS 


FEB1 


A0 


40 




PUTBYTE 


LOY #40 


B3 


8C 


22 


0E 




STY 1AD0R 


B6 


A0 


07 






LOY #07 


B8 


8C 


20 


0E 




STY 1PIA 


BB 


6A 








ROR A 


BC 


6A 








ROR A 


FEBD 


20 


CD 


FE 


AGAIN 


JSR WAIT 


C0 


6A 








ROR A 


G1 


80 


20 


0E 




STA1PIA 


C4 


88 








DEY . ■ftfL. 


C5 


10 


F6 






(•BVe'AGAIN 


C7 


20 


CD 


FE 




JSR WAIT 


CA 


8C 


20 


0E 




STY 1PIA 


FECD 


20 


00 


FE 


WAIT 


JSR '/j WAIT 


FED0 


84 


1A 




'72 WAIT 


STY Z TY 


D2 


A0 


48 






LOY #48 


D4 


88 






WAIT 1 


DEY 


D5 


00 


FO 






BNE WAIT 1 


DY 


88 






WAIT 2 


DEY 


D8 


00 


FD 






BNE WAIT 2 


DA 


A4 


1A 






LDY2TY 


DC 


60 








RTS 


FEDD 


A0 


08 




GETBYTE 


LOY #08 


FEDF 


2C 


20 


0E 


START 


BIT1PIA 


E2 


30 


FB 






BMI START 


E4 


20 


00 


FE 




JSR %WAIT 


FEE7 


20 


CD 


FE 


INPUT 


JSR WAIT 



QUAD DATA FETCH - DISPLAY OLO 

DATA 

GET KEY 

NGN HEX RETURN 

LOOP COUNTER 



DIGIT IN A IN CORRECT PLACE 
MULTI SHIFT TO GET DIGIT INTO 
MEMORY 
INDEXED 



- KEEP SHIFTING IN 

- GO AND DO IT ALL AGAIN 

- INCREMENTS COMPARE 16 BIT 
NOS - INCREMENT LOWER 

- NO HIGH INCREMENT 

- LOW BYTE EQUALITY TEST 

- NO NEED TO 00 HIGH BYTE 

- HIGH BYTE EQUALITY TEST 



PUT BYTE TO TAPE - CONFIGURE 
I/O PORT 

LOOP COUNTER 

AND SEND THE START BIT 

BACK A UP A COUPLE OF BITS 
WAIT TO SEND OUT RESET BIT 
SENDING ORDER IS BIT 0->8IT 7 
SEND BIT 

KEEP GOING 

WAIT FOR THAT BIT TO END 

SEND STOP BIT : Y IS FF 

300 BAND WAITING TIME - IN TWO 

PARTS 

'/= THE WAITING TIME -SAVE Y 

72 X5/iS DELAY 

PART ONE OF THE WAIT 

Y WAS ZERO ON ENTRY - 256 x 5jUS 
DELAY 

RETRIEVE Y 

GET BYTE FROM TAPE - LOAD 

COUNTER 

WAIT FOR 1 ->-0TRANSISITON - 

A START BIT 

WAIT HALF THE TIME, SO 
SAMPLING IN THE CENTRE 
FULL WAIT TIME BETWEEN 
SAMPLES 



(16 BITS) APPEAR IN A USABLE FORM FOR THE OUTSIDE WORLD. THE ACORN 
MONITOR USES DEVICE 81 TO CONTROL THE DISPLAY, CASSETTE INTERFACE 
AND KEYBOARD. 
EACH ONE OF THE 16 LINES MAY BE PROGRAMMED TO BE AN INPUT OR AN 



CONTROL 
LINES 



Output I 

Definition; 

Register! 



DB7-D80 



ADG-AD0 




PORT 
A 



Clz> PA7-PA0 



INTR 



<^ PB7-PB0 



128x8 RAM 



8154 RAM I/O 



OUTPUT DEPENDING ON THE STATE OF INTERNAL CONTROL REGISTERS. 
ONLY A GENERAL DESCRIPTION OF THE DEVICE IS GIVEN HERE, IN 
ADDITION TO THE FOLLOWING FUNCTIONS PORT A MAY BE SET TO 
OPERATE IN A VARIETY OF DIFFERENT HANDSHAKING TRANSFER MODES 
BY USE OF THE MODE DEFINITION REGISTER. IT SHOULD BE NOTED THAT 
THESE MODES REQUIRE CONNECTION OF INTERRUPT AND THAT THE 
INS8154 INTERRUPT LINE IS THE INVERSE OF THAT REQUIRED BY THE 
PROCESSOR. 



THE 16 LINES ARE, AS YOU MIGHT EXPECT, DIVIDED INTO TWO SEPERATE 

BYTE SECTIONS A & B. A & B BOTH HAVE AN "OUTPUT DEFINITION 

REGISTER" ASSOCIATED WITH THEM. EACH BIT IN THE O.D.R. DEFINES THE 

ASSOCIATED BIT IN THE 'PORT AS EITHER AN INPUT (0) OR AN OUPUT {!). 

THUS, IN THE MONITOR WE WRITE FF TO THE SEGMENT O.D.R. TO USE ALL 

IT'S LINES AS OUTPUTS, AND 'DISPLAY' WRITES 07 TO THE DIGIT DRIVE 

O.D.R. TO HAVE 3 OUTPUTS AND 5 INPUTS. 

NOT ONLY MAY WE READ/WRITE TO THE OUTPUT PORT USING THE 

PARALLEL FIEAD & WRITE OPERATIONS, BUT WE MAY ALSO READ/WRITE 

SINGLE BITS: 

OPERATION 

SET BIT0 PORTA 

SET BIT 7 PORTA 

CLEAR B1T0 PORTA 

CLEAR BIT 7 PORTA 

READ BIT0 PORTA 

READ BIT 7 PORTA 

SET BIT1 PORTB 

SET BIT 6 PORTB 

CLEAR BIT 2 PORTB 

CLEAR BIT 5 PORTB 

READ BIT 4 PORTB 

PORTA 

PORTB 

O.D.R.A. 

O.D.R.B. 

IF YOU READ A SINGLE BIT IT WILL END UP IN BIT 7 OF A BYTE, THUS THE 
BIT INSTRUCTION WILL ASSIGN IT TO THE TESTABLE N FLAG. 
THE INS8154 ALSO CONTAINS A USEFUL 128 BYTES OF RAM. THIS IS 
CONTINUOUS FROM (ADDRESS LOW) 80 TO FF. 
DEVICE B1 IS ENABLED FOR ADDRESS HIGH OF 0E, DEVICE B2 IS AT 09. 
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00 
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07 
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00 or 10 


R 


07 or 17 


R 
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W 


IE 


W 


0A 


W 


0D 


W 


0Cor1C 


R 


20 


RorW 


21 


RorW 


22 


W 


23 


W 



FE3E 


E4 


19 


BUTTON 


CPX 2 COL 


40 
42 


D0 
C9 


F0 
38 




BNE DELAY 
CMP #38 


44 
46 


90 
A9 


04 
80 




BCC PRESSED 
LDA #80 


48 

FE4A 

4C 


D0 
C5 
F0 


E6 
0F 
E4 


PRESSED 


BNE KEYCLEAR 
CMP 2 EXEC 
BEQ DELAY 


4E 
50 


85 
49 


0F 
38 




STA2 EXEC 
EGR #38 


FE52 


29 


IF 


OUTPUT 


AND#IF 


54 


C9 


10 




CMP #10 


56 


85 


0D 




STASKEY 


58 

5A 

5D 

FE5E 


A6 
82 
60 
A0 


1A 

21 0E 

00 


MHEXTD 


LDX Z TX 
STY 1PIB 
RTS 
LDA (00, X) 


FE60 


A0 


06 


RDHEXTD 


LDY #06 


62 

FE64 


D0 
A0 


0B 
03 


QHEXTD1 


BNE DHEXTD 
LDY #03 



FE66 B5 00 QHEXTD2 LDA 21^00 

68 20 6F FE JSR DHEXTD 

68 88 



^^ FE6C an 

6D 85 01 

.^,> FE6F C8 DHEXTD 

70 48 

71 20 7A FE 

74 88 

75 68 

76 4A 

77 4A 

78 4A 

79 4A 

FE7A 84 1A HEXTD 

7C 29 0F 

7E A8 

7F 89 EA FF 

82 A4 1A 

84 99 10 00 



DEY 
DEY 

LDA 2, X 01 

INY 

PHA 

JSR HEXTD 

DEY 

PLA 
LSR A 
LSR A 
LSR A 
LSR A 

STY H TY 

AND#0F 

TAY 

LDA, Y FONT 

LDY 2 TY 

STA,Y D 



ARE WE ON THE SAME KEY'S 

COLUMN? 

NO 

HAS A KEY ACTUALLY BEEN 

PRESSED? 

YES 

NO, THEN CLEAR THE EXECUTION 

STATUS - THE KEY HAS BEEN 

PRESSED & RELEASED 

ALWAYS BRANCH 

A KEY HAS BEEN PRESSED 

BUT IT HAS ALREADY BEEN 

EXECUTED 

SET IT AS BEING EXECUTED 

JIGGERY POKERY TO ENCODE THE 

ROW INPUTS TO BINARY 

ALSO ENSURE THE KEY IN REPEAT 

WAS OF REASONABLE SIZE 

A HEX KEY OR NOT? CARRY CLEAR 

IF HEX 

PUT THE KEY IN A TEMP LOCATION 

FOR FURTHER USE (BY "MODIFY") 

RETRIEVE X 

TURN THE SEGMENT DRIVES OFF 

AND RETURN 

MEMORY HEX TO DISPLAY = GET A 

BYTE FROM MEMORY 

RIGHT (OF DISPLAY) DOUBLE HEX 

TO DISPLAY : SET Y TO RIGHT OF 

DISPLAY 

AND USE DHEXTD 

QUAD HEX TO DISPLAY 1 : SET Y 

TO USE POSNS 1 ,2,3 & 4 

2: USE ANY Y; GET THE DATA 

AND USE DHEXTD 

HAVING DECREMENTED THE 

POSITION 

GET THE HIGH BYTE OF THE DATA 

& USE DHEXTD 

DOUBLE HEX TO DISPLAY : FIRST 

HEX ON RIGHTEST POSITION 

SAVE A 

USE HEX TO DISPLAY 

GET Y BACK TO CORRECT 

POSITION 

RETRIEVE A 



ORIENTATED FOR OTHER HEX 

DIGIT 

HEX TO DISPLAY = SAVE Y 

REMOVE SURPLUS BITS FROM A 

& PUT IT IN 7 

GET THE 7 SEGMENT FORM 

RETRIEVE Y 

AND POSITION THE 7 SEG FORM ON 

THE DISPLAY 



ACORN MONITOR 



ADDR HEX 

CODE 
FE00 A0 06 



LABEL 



QUAD 



FE02 B5 00 STILL 
04 20 6F FE 



07 


CA 


08 


88 


09 


88 


0A 


10 F6 



FE0C 86 1A DISPLAY 

FE0E A2 07 RESCAN 

10 8E 22 0E 

FE13 A0 00 SCAN 

15 B5 10 

17 80 21 0E 

1A 8E 20 0E 

ID AD 20 0E 

20 29 3F 

22 24 0F 

24 10 18 

26 70 0A 



INSTRUCTION 
LDY #06 



LDA 2X 00 
JSR DHEXTD 

DEX 
DEY 
DEY 
BPL STILL 



STX 2 TX 
LDX #07 
STX 1 ADDR 

LDY #00 
LDA 2,X D 

STA 1PIB 
STX 1PIA 

LDA IP! A 
AND #3F 
BITH EXEC 

BPL BUTTON 
BVS DELAY 



28 


C9 


38 




CMP #38 


2A 


B0 


06 




BCS DELAY 


2C 


86 


19 




STX H COL 


2E 


A9 


40 




LDA #40 


FE30 


85 


0F 


KEY 
CLEAR 


STA 2 ECEC - 


FE32 


88 




DELAY 


DEY ^— ^ 


33 


D0 


FD 




BNE DELAY 


35 


CA 






DEX 


FE36 


10 


DB 




BPL SCAN 


38 


A5 


0E 




LDA 2 REPEAT 


3A 


30 


D2 




BMI RESCAN 


3C 


10 


14 




BPL OUTPUT 



COMMENTS 

DISPLAY THE 4 BYTES AT X-3,X-2, 
X-1 & X IN THAT ORDER ON THE 
DISPLAY 

- GET THE BYTE POINTED TO BY X 

- USE DOUBLE HEX TO DISPLAY 
ROUTINE 

- NEXT X 

- NEXT Y POSITION 

- FALL AUTO DISPLAY WHEN 
FINISHED -Y POSITION & ALSO 
LOOP COUNTER 

- SAVE XI!!! 

- SCAN 8 DIGITS, NO MATTER WHAT 

- SET UP DATA DIRECTION 
REGISTER 

- CLEAR Y FOR LATER USE 

- GET DISPLAY DATA FROM THE 
ZERO PAGE MEMORY 

- & PUT IT ONTO SEGMENTS 

- SET DIGIT DRIVE ON AND THE KEY 
COLUMNS 

- GET KEY DIGIT BACK 

- REMOVE SURPLUS TOP BITS 

- CHECK STATUS = 'I' MEANS NOT 
PROCESSING A KEY 

- BUT MEANS THAT WE ARE 

- THUS CAN BE BLOWN TO AN 
ESCAPE FROM THE DISPLAY 
ROUTINE ALTOGETHER ON STATUS 
C0 AT THE MOMENT IT IGNORES 
KEYS IF GIVEN THIS STATUS 

- CHECK FOR ALL 1'S ROW INPUT 
FROM KEYBOARD = SET COPY lOFSO 

- IF ALL I's THEN NO KEY HAS BEEN 
PRESSED 

- STORE THE PRESSED KEY'S 
COLUMN INFORMATION 

- SET STATUS TO "WE ARE 
PROCESSING A KEY" 



Y WAS ZERO SO HERE IS A 256X5/iS 
DELAY 

Y WILL BE ZERO ON EXIT 

IF X WAS STILL TVE, CONTINUE 

THIS SCAN 

IF WE SHOULD CONTINUE 

SCANNING THEN TOP BIT IS SET 

CONTINUE SCANNING 

IF TOP BIT IS ZERO, THEN USE THIS 

DATA AS THE KEY ITSELF 



ALSO ON THE CPU BOARD ISA5V REGULATOR. THIS PROVIDES THE 
REGULATED +5V POWER SUPPLY USED BY ALLTHE LC.S. ON THE BOARD, AND 
THE KEYBOARD/INTERFACE BOARD WHEN CONNECTED. IF THE 2704 OR 
2708 TYPE OF E.P.R.O.M. IS EMPLOYED IN SOCKET E, EXTRA +12 & -5 V 
POWER SUPPLY LINES ARE REQUI RED, AND TWO TRACKS ON THE P.C.B. 
NEED CUTTING. 




THE TWO CUTS ARE ON THE REAR 
OF THE MPU BOARD IN THE TOP 
LEFT HAND CORNER. X's MARK 
THE SPOTS 



(THERE IS NO PROVISION FOR ON-BOARD REGULATORS FOR THESE TWO 

EXTRA SUPPLIES). 

OF COURSE, THE 2716 EPROM NEEDS NO EXTRA SUPPLY LINES, AND IS THE 

DEVICE THAT THE P.C.B. WAS DESIGNED FOR, IT PLUGS STRAIGHT INTO 

SOCKET E. 

THE CONNECTOR H CARRIES THE ADDRESS BUS, THE DATA BUS, THE 

CONTROL BUS, POWER SUPPLY LINES AND THE 16 INPUT/OUTPUT LINES 

FROM B2. THIS WILL PLUG INTO A BACKPLANE WHICH TAKES THE BUSSES 

TO OTHER ACORN CARDS. 

5.5 THE KEYBOARD AND TAPE INTERFACE 

ATTHE OTHER ENDOFTHE BOARD, CONNECTOR I CARRIES ALL 16 l/OLINES 
FROM DEVICE B1, AS WELL AS 0V,+5V, 02 & RESET LINES. WITH THE 
INTELLIGENT ACORN MONITOR AND THE KEYBOARD BOARD, THE I/O LINES 
ARE DEDICATED AS FOLLOWS 

SEGMENT DRIVES 
BINARY ENCODED DIGIT DRIVES 
KEYBOARD ROW INPUTS 
FROM COMPUTER TO CASSETTE 
FROM CASSETTE TO COMPUTER 



B1 PORT B0-7 


OUTPUTS 


A0-2 


OUTPUTS 


A3-5 


INPUTS 


A6 


OUTPUT 


A7 


INPUT 



-A COMMENT FOR THOSE INTERESTED; ALTHOUGH THE KEYBOARD ONLY 
CONSISTS OF 24 KEYS AT PRESENT, IT IS POSSIBLE, WITH A PRIORITY 
ENCODER ON THE ROW INPUTS, TO USE UP TO 56 KEYS. THE DISPLAY 
SUBROUTINE WILL COPE CORRECTLY WITH THE UNKNOWN KEYS, EXCEPT 
THAT. AT THE POINT. OUTPUT. IT THROWS AWAY A SIGNIFICANT BIT OF 
INFORMATION. HOWEVER, THE ACTUAL KEY VALUE HAS BEEN STORED IN 
LOCATION 000F AND SO CAN BE RECOVERED. THE UNKNOWN KEYS Wl LL NOT 
AFFECTTHE MONITOR ITSELF, SINCE AT THE POINT SEARCH MORE ITS OF 
INFORMATION IS THROWN AWAY, LEAVING THE MONITOR WITH A CHOICE 
OF EIGHT VALUES. 

THE SUBROUTINE DISPLAY RUNS THE DISPLAY IN A MULTIPLEXED MANNER, 
AT THE SAME TIME STROBING AND DEBOUNCING THE MATRIXED KEYBOARD 
ON THE KEYBOARD BOARD. EACH OF THE EIGHT COLUMNS OF THE 8X3 
KEYBOARD IS DRIVEN BY ONE OF THE EIGHT DIGIT DRIVER LINES, THE 
THREE ROW LINES ARE CONNECTED TO DEVICE 81, AND THEY ARE PULLED 
TO LOGIC ONE BY THE 4K7 RESISTORS. IN CONJUNCTION WITH ITS COLUMN 
BEING DRIVEN LOW, A CLOSED KEY PRODUCES A LOW ON ONE OF THE ROW 
INPUTS ■ . . +5V 

4K7 



M 



R 



t 



S5 



ALL THE INTERFACE BETWEEN THE MICROPROCESSOR AND THE KEYBOARD 
AND DISPLAY IS THUS ACCOMPLISHED BY ONE OCTAL DECODER/DRIVER 
AND THREE RESISTORS. THE REST OF THE CIRCUITRY ON THE INTERFACE 
BOARD ALLOWS PROGRAMS TO BE RECORDED ON CASSETTE AT THIRTY 
BYTES PER SECOND, THE INTERFACE IS SLIGHTLY MORE COMPLICATED 
THAN THE SINGLE I.C. AND THREE RESISTORS USED ABOVE, IT HAS TWO 
TASKS. 

i CONVERT THE SERIAL STREAM OF INFORMATION PRODUCED BY PUTBYTE 
INTO TONES SUITABLE FOR AN UNMODIFIED CASSETTE RECORDER TO 
RECORD.THE FREQUENCIES USED ARE 2403.8 HZ FOR A LOGIC ONE AND 
1201.9 HZ FOR A LOGIC ZERO. THE FREQUENCIES ARE PRODUCED BY 
DIVIDING ^, WHICH IS CRYSTAL CONTROLLED AT 1 MHZ, BY 416 OR 832. 
II CONVERT THE PLAYED BACK FREQUENCIES INTO A STREAM OF BINARY 
INFORMATION. THE PLAYBACK IS 'AMPLIFIED' INTO A SQUARE WAVE, AND 
ITS PERIOD IS COMPARED WITH THE PERIOD OF A REFERENCE DIGITAL 
MONOSTABLE ON THE CIRCUIT BOARD 
BECAUSE OF THE AMPLIFICATION STAGE, THE OUTPUT FROM A TAPE 
RECORDER'S 'LINE' OUTPUT, OR THE 'EAR' JACK SOCKET, SHOULD PERFORM 
SATISFACTORILY EVEN AT MODEST VOLUME LEVEL. HOWEVER THE 
COMPUTER OUTPUT IS AT QUITE HIGH LEVEL AND SHOULD BE ATTENUATED 
FOR THE TAPE RECORDER. TO PREVENT NOISE PICK-UP THIS SHOULD BE 



WITH THE COMPLETE PROCESSOR STATUS RECOVERED. THUS IF WE FINISH 

THE PROGRAM 

020D 69 19 ADC #19 

020F 2060FE JSR RDHEXTD 

0212 4C04FF JMP RESTART 

0215 

AND PRESS R,THE DISPLAYED ANSWER WILL BE 03 

6.3 THE SINGLE STEPPING FACILITY 

A MORE INTERESTING USE OF THE ROUTINE BREAK AT FFB3 IS IF YOU GENERATE 
GENERATE A NMI EVERY OPCODE FETCHED NOT IN THE MONITOR, AS DISCUSSED 
DISCUSSED IN THE HARDWARE SECTION THE SYNC PULSE ISSUED DURING AN 
OPCODE FETCH IS LESS THAN 1 CYCLE LONG, WHILE NMI REQUIRES AT LEAST 2 
CYCLES. A LATCH IS REQUIRED TO STRETCH THE SYNC SIGNAL 



%74L574 



BC 107 



SYNC _n_ 



PROMENABLE 
SIGNAL 




TO NMI OPEN 
COLLECTOR LINE 



SINGLE STEP OPEN 



AND IT ALSO ONLY PROVIDES AN NMI WHEN NOT IN THE MONITOR. BEFORE 
EXECUTING A PROGRAM SET THE NMI VECTOR (LOCATIONS 001C & 001D) TO 
BREAK (FFB3) THE PROGRAM COUNTER RECALCULATION, IN 001B, SHOULD 
BE 00. EACH INSTRUCTION EXECUTED CAUSES THE MONITOR TO DISPLAY THE 
STATUS OF THE PROCESSOR, PRESSING R CAUSES THE NEXT INSTRUCTION TO 
BE EXECUTED. YOU MAY USE THE MONITOR TO ALTER A,X,Y (LOCATIONS) 
000A, B&C)OR P (AT STACK POINTER + 1), BEFORE THE NEXTSTEP. IT IS 
INADVISABLE TO CHANGE PC (STACK POINTER +2 & +3), BUT THIS CAN BE 
DONE AS WELL. THE SINGLE STEP EXECUTION CAN BE STOPPED IN TWO WAYS 
i GROUND NMI LINE/GROUND THE SET INPUT OF THE D FLIP-FLOP 
li POINT THE NMI VECTOR AT AN RTI INSTRCTION, SAY THE ONE AT FFID 
(EXECUTION OF A PROGRAM WILL BE SLOWED DOWN BY A FACTOR OF 5 OR 
SO DUE TO THE PERSISTENT NMI'S.) 

AN IMPORTANT NOTE; THE BREAK ROUTINE SETS THE REPEAT LOCATION 
TO FF, SO THAT IT, AND THE MONITOR, MAY SAFELY USE THE DISPLAY 
ROUTINE. IF YOU NEED TO USE SINGLE SCANS AND BREAKS TO THE BREAK 
ROUTINE, SOME INGENUITY WILL BE REQUIRED, OR SOME DEDICATED 
BUTTON PUSHING. 

NOW THE COMPLETE MONITOR LISTING. THIS IS WRITTEN TO FIT IN THE TWO 
512X4 PROMS. 



AFTER THE ADDRESS IS SET UP, THEN ANY KEY Wl LL CHANGE THE STATE 
OF IT'S CONTENTS: IF NOT A BREAK, A BREAK IS INSERTED, THE 
ORIGINAL DATA IS SAVED IN LOCATION 0018. IF A BREAK, THEN THE 
CONTENTS OF 0018 ARE INSERTED. THE RESULTING STATE OF THE 
LOCATION IS DISPLAYED 



DONE IN THE PLUG CONNECTING TO THE RECORDER 



0200 



0. 



WE ARE NOW BACK AT FF04. BUT t & 4- NOW OPERATE ON THE P ADDRESS. 

CONTENTS OF A LOCATION MAY BE CHANGED AS IF THIS WERE M. 

PRESSING P TWICE WILL INSERT A BREAKPOINT (ONLY A SINGLE 

LOCATION'S BACK-UP COPY IS RETAINED) AND SEND YOU BACK TO FF04. 

THE M KEY WILL RETURN IT'S MEMORY ADDRESS WHEN PRESSED 
NOW THE PROGRAM IS SITTING THERE WITH A BREAK AT 0200. EXECUTION 
OF THIS BREAK WILL CAUSE AN I RQ AND CONTROL IS TRANSFERRED TO 
THE ADDRESS IN LOCATION 00IE & 001F: FOR DIAGNOSTICS THIS ADDRESS 
SHOULD BE FFB3 (THE B3 IN 00IE & THE FF IN m\E) ALSO - 1^ 

THE PROGRAM COUNTER REQUIRES RESETTING AFTER A BREAK. THE 
AMOUNT BY WHICH THIS IS DONE, 02, SHOULD BE STORED IN LOCATION 001 B 
NOW EXECUTING THE BREAK CAUSES THE STATUS OF THE PROCESSOR TO 
BE DISPLAYED IN THE FOLLOWING FORM 



FIRST DISPLAY SET; 
SECOND DISPLAY SET: 



A X 


Y 


P 


PC 


SP 



(HEX PAIRS OF DATA IN EACH) 

(TWO BYTES EACH, SECOND SET DISPLAYED 

AFTER ANY KEY IS PRESSED). 



-SET INTERRUPT DISABLE 
-CLEAR OVERFLOW 
-CLEAR CARRY 
-SET DECIMAL MODE 
11 

33 

-INITIALISE STACK 

22 



FOR THE FIRST DISPLAY SET AND 



FOR THE SECOND SET. 
THE ACTIVE FLAGS ARE THE DECIMAL AND INTERRUPT DISABLE FLAGS, 
(THE 2 PART OF THE STATUS REGISTER'S 2C IS AN UNUSED FLAG), THE 
PROGRAM WAS STOPPED AT LOCATION 020D WITH AN EMPTY STACK (THREE 
BYTES, PCH, PCL, P,WERE AUTOMATICALLY STACKED BY THE BRK 
INSTRUCTION). YOU MAY NOW CONTINUE TO WRITE (OR CORRECT) THE 
PROGRAM, USING THE MONITOR AS USUAL (BUT AVOID PRESSING THE RESET 
KEY SINCE THE STACKED PCH, PCL & P WILL BE DESTROYED) PRESSING THE 
R KEY WILL RETURN YOU TO 0200 TO TRY CONTINUING THE PROGRAM, 



THIS PROGRAM 




0200 


78 


SEI 


0201 


B8 


CLV 


0202 


18 


CLC 


0203 


F8 


SED 


0204 


A9 11 


LDA#11 


0206 


A2 FF 


LDX#FF 


0208 


A033 


LDY#33 


0209 


9A 


TXS 


020B 


AZ22 


LDX#22 


020D 


00 


BRK 


020E 






CAUSES 




1 1 22333C 
020D01 F C 



^^S 




PLUG 



SCREENED LEAD 



'FROM' TAPE 
GROUND 



BEST RECORDING RESULTS WITH A LEVEL OF ABOUT TWO-THI RDS MAXIMUM 
LEVEL. THE VERY CHEAPEST TAPE RECORDERS SOMETIMES USE A DC. ERASE 
SYSTEM, AND SUBSTANTIALLY POORER RESULTS MAY OCCUR ON RECORDING 
OVER AN ALREADY RECORDED SECTION OF TAPE. HIGH FREQUENCY 
RESPONSE IS ATAPREMIUM IN THIS APPLICATION, THE TAPE RECORDER'S 
HEADS SHOULD BE CLEANED FREQUENTLY, AND, PREFERABLY, 
DEMAGNETISED EVERY"8-10 HOURS. LOW QUALITY TAPES SHOULD BE 
AVOIDEDSINCETHEYOFTEN CAUSE VERY FAST BUILD UP OF DIRT ON THE 
HEADS. THE SPEED OF THE REPLAYED DATA SHOULD NOT DEVIATE BEYOND 
±5% OF THE RECORDEDSPEED, SO DON'T USE BATTERIES FOR POWER, (OR C12(Z 
CASSETTES SINCE THE THINNER, HEAVIER TAPE OFTEN GETS STUCK). CLEAN 
THE EXPOSED CAPSTAN AND PRESSURE WHEEL WHEN YOU CLEAN THE 
HEADS: A HEAD CLEANING TAPE MAY NOT MANAGE TO REMOVE OXIDE 
BUILD-UP FROM THE MECHANISM. 

5.6 POWER SUPPLY 

THETW0B0ARDSARESUPPLIEDBYTHE5V REGULATOR ON THE CPU BOARD. 
IF ALL THE I.C.S. ARE IN PLACE ON THE CPU BOARD, THEN AT LEAST 600 MA 
IS REQUIRED. PROPER REGULATION IS ENSURED BY NEVER LETTING THE 
INPUT UNREGULATED SUPPLY DROP BELOW -H7V. WHILE THE REGULATOR IS 
PERFECTLY HAPPY WITH -I-27V INPUT, IT Wl LL NEED TO DISSIPATE 13.2W AND 
WILL GET EXTREMELY HOT. . . AND TURN ITSELF OFF DUE TO THERMAL 
OVERLOAD. LOSING YOUR NICE PROGRAM IN THE R.A.M. UNLESS AN 
ADDITIONAL HEAT SINK IS USED, -H2V SHOULD BE REGARDED AS AN 
ABSOLUTE MAXIMUM UNREGULATED INPUT, THE REGULATOR WILL NOT GET 
SO HOT AS TO TURN ITSELF OFF, BUT YOU MIGHT RECEIVE A BURN IF YOU 
TOUCH IT. 



ADDITIONAL HEATSINK 




CHAPTER 6: FIRMWARE 
6.1 TAPE STORE AND LOAD 

IN THE SOFTWARE SECTION WE USED SOME OF THE FUNCTIONS OF THE 
ACORN MONITOR TO WRITE AND EXECUTE SOME SIMPLE PROGRAMS WHICH 
DEMONSTRATED FEATURES OF THE MICROPROCESSOR AND PROGRAMMING. 
THE MONITOR IS MORE POWERFUL THAN DEMONSTRATED IN THAT SECTION, 
AND HERE WE'LL EXAMINE IT MORE CLOSELY, AND GIVE A COMPLETE 
LISTING OF IT. AFTER THE M, G, t AND J. KEYS, THE MOST USEFUL KEYS Wl LL 
PROBABLY BE S AND L THESE ENABLE YOU TO STORE AND LOAD 
PROGRAMS OF ANY SIZE USING CASSETTE TAPE OR A SIMI LAR RECORDING 
MEDIUM. LET'S ASSUME WE WISH TO CREATE A TAPE VERSION OF THE DUCK- 
SHOOT GAME. THIS WILL HAVE BEEN ENTERED IN MEMORY FROM ADDRESS, 
SAY, 0200 TO ADDRESS 023F INCLUSIVE. AFTER TESTING THAT THE 
PROGRAM ACTUALLY DOES WORK, PRESS THE S KEY. 

F. X X X X 

THE MONITOR IS PROMPTING YOU TO ENTER THE ADDRESS FROM WHICH 
YOU WANT TO RECORD. THE DISPLAYED ADDRESS IS EITHER GARBAGE 
OR THE LAST END ADDRESS USED. ENTER THE ADDRESS, TERMINATING 
WITH ANY COMMAND KEY 

F. 2 00 

XXXX 

THE MONITOR IS NOW PROMPTING YOU TO ENTER THE END ADDRESS. THIS 
IS THE ADDRESS OF THE LAST BYTE IN YOUR PROGRAM + 1. THE 
DISPLAYED ADDRESS IS EITHER GARBAGE OR THE LAST END ADDRESS 
USED. ENTERTHE ADDRESS, BUT DON'T TERMINATE IT YET 

0240 

THE SYSTEM IS NOW READY TO SERIALLY OUTPUT THAT SECTION OF 
MEMORY. YOU SHOULD RECORD A BRIEF VERBAL DESCRIPTION OF THE 
PROGRAM - "DUCKSHOOT" - AND ALSO THE ADDRESSES (OR ADDRESS OF 
START AND LENGTH) WHICH THE PROGRAM USES. KEEP A LIST OF WHICH 
PROGRAMS ARE STORED ON EACH TAPE. NOW CONNECT IN THE COMPUTER 
AND START RECORDING. AFTER A FEW SECONDS, PRESS ANY COMMAND 
KEY TO TERMINATE THE ADDRESS ENTRY. THE DISPLAY Wl LL GO BLANK, 
WHILE THE PROCESSOR DEVOTES ITSELF TO SENDING THE INFORMATION 
TO THE TAPE. WHEN THE DISPLAY 

0240 



REAPPEARS, YOU MAY STOP THE TAPE-RECORDER: THE RECORDING IS 
COMPLETE, AND YOU ARE BACK AT FF04. ANY HEX KEY HERE WILL BRING 
BACK THE MONITOR'S DOTS, OR YOU MAY JUST START USING THE 
MONITOR. THE RECORDING PROCEEDS AT 30 BYTES PER SECOND, THIS 
PROGRAM, AT 68 BYTES (PROGRAM LENGTH + 4 BYTES OF ADDRESS 
INFORMATION) TOOK ONLY TWO SECONDS TO RECORD. 



TO LOAD A PROGRAM FROM THE TAPE YOU SHOULD BE IN A SITUATION 
WHERE MONITOR COMMANDS ARE ACCEPTED, NOT WHERE YOU ARE 
ALLOWED ANY KEY TO TERMINATE AN ADDRESS ENTRY. PLAY THE TAPE, 
AND, WHEN THE 2403.8 HZ LEADER IS HEARD, PRESS THE L KEY. THE 
DISPLAY WILL BE BLANK UNTIL DATA IS ENCOUNTERED ON TAPE, WHEN 
EACH BYTE ENTERED Wl LL BE DISPLAYED AS A SYMBOL ON THE LEFTMOST 
DIGIT. WHEN THE LAST BYTE HAS BEEN READ THE PREVIOUS DISPLAY WILL 
RETURN - YOU'RE AT FF04 AGAIN. THE ADDRESSES INTO WHICH THE 
PROGRAM IS LOADED WILL BE THOSE WITH WHICH IT WAS STORED ON TAPE, 
BUT YOU MAY WISH TO DELIBERATELY AVOID THIS. JUST USING THE MONITOR, 
THE BEST THAT CAN BE DONE IS TO TREAT THE ENTIRE RECORDING AS DATA 
AND LOAD ENOUGH OF IT TO FIT BETWEEN TWO ADDRESSES: THE FIRST 
FOUR BYTES LOADED WILL THUS BE THE ORIGINAL ADDRESSES THE 
PROCEDURE IS 

I SET ADDRESSES 0008 & 0009 TO THE LOW & HIGH BYTE OF THE ADDRESS 
INTO WHICH YOU WISH TO PUT THE Fl RST BYTE. 

II SET ADDRESSES 000A&000B TO THE LOW & HIGH BYTE OF THE LAST 
ADDRESS +1 I NTO WHICH YOU WANT THE DATA TO BE LOADED. 

I I I SET UP THE GO ADDRESS OF FF8A, START THE PLAYBACK, WHEN YOU 
HEAR THE 2403.8 HZ LEADER, PRESS ANY KEY TO GO. LOADING Wl LL 
OCCUR BETWEEN THE ADDRESSES SPECIFIED. 

THE ABOVE PROCEDURE MAY NOT BE SATISFACTORY: IT LOADS THE 
PROGRAM'S ADDRESSES AS DATA, AND DESTROYS THE DATA IN REGISTERS 
AND 1 (A & X AFTER A BREAKPOINT) BETTER METHODS ARE GIVEN IN THE 
SYSTEM SECTION OF THE APPLICATION PROGRAMS 
THE LAST COMMENT ON LOAD FROM TAPE IS THAT IT IS POSSIBLE TO 
CREATE A PROGRAM ON TAPE THAT WILL, WHEN LOADED, SEIZE CONTROL 
AND EXECUTE ITSELF THIS IS IDEAL FOR, SAY, A BASIC INTERPRETER: YOU 
JUST HAVE TO LOAD IT, AND IT AUTOMATICALLY SETS ITSELF RUNNING 
AND PROMPTS READY. THE IDEA IS TO LOAD THE PROGRAM INTO THE 
monitor's zero page REGISTERS, LOADING THE PROGRAM START ADDRESS 
INTO GAP AND THE GO KEY (II) INTO REPEAT . CARE MUST BE TAKEN WHEN 
YOU LOAD INTOfAP AND JAP: YOU MUST BE SURE TO LOAD WHAT'S 
ALREADY THERE, OR SOMETHING SENSIBLE! 

6.2 THE BREAKPOINT AND RESTORE COMMAND 

THE FINAL TWO MONITOR FUNCTIONS ARE EMBODIED BY THE KEYS R AND 
P. YOU MAY ALREADY HAVE DISCOVERED THAT PRESSING R IS DISASTROUS, 
AND THAT P IS LIKE M, BUT WITH A PENCHANT FOR INSERTING 00 INTO THE 
ADDRESS SPECIFIED. WITH THESE KEYS YOU ARE EXPECTED TO DEBUG (A 
BUG IS ANY SMALL MISTAKE PREVENTING A PROGRAM FROM 
FUNCTIONING) YOUR PROGRAMS. THE P KEY ALLOWS YOU TO INSERTTHE 
BREAK INSTRUCTION ON TOP OF AN INSTRUCTION AT A POINT WHERE YOU 
SUSPECTSOMETHING SUSPICIOUS IS HAPPENING, SAY 0200: 



0200 



